1. 项目概述为什么Python的“基础语法”值得花一整天来啃如果你刚开始学Python可能会觉得“基础语法”这几个字听起来有点枯燥远不如直接写个爬虫或者做个数据分析项目来得刺激。我刚开始接触编程时也是这么想的总想跳过这些“无聊”的部分直奔那些看起来酷炫的功能。但后来踩了无数坑之后才明白Python基础语法尤其是我们今天要重点聊的缩进规则和函数初步根本不是“基础”而是“地基”。地基打不牢后面盖什么楼都容易塌。很多人包括几年前的我在写Python时遇到的第一个“拦路虎”往往不是复杂的算法而是一个看起来人畜无害的报错IndentationError: unexpected indent。你可能只是随手多敲了一个空格或者把Tab和空格混用了程序就直接罢工了。这背后体现的是Python设计哲学的核心之一——用缩进来定义代码块结构。这与C、Java等用花括号{}的语言截然不同也是Python代码以简洁、优雅著称的重要原因。但这份优雅对新手来说最初带来的可能是困惑。所以在“21天打卡”的第3天我们不放眼望去而是沉下心来把这两块“地基石”彻底搞明白。我会结合我这些年写代码、带新人时遇到的真实案例把那些官方文档里一笔带过但实际 coding 时天天碰到的细节掰开揉碎讲给你听。目标很简单让你写完今天的内容后再看到缩进错误能一眼定位对函数的基本用法心里有底为后续更复杂的学习铺平道路。2. 核心语法一Python的缩进规则——不止是“对齐”那么简单2.1 缩进Python的语法脊梁在大多数编程语言里缩进只是为了代码美观属于“锦上添花”。但在Python这里缩进是语法的一部分是“雪中送炭”。编译器或解释器依靠缩进来判断代码之间的逻辑从属关系。一个最简单的例子if语句。# 正确的缩进 age 18 if age 18: print(你已经成年了。) # 这行属于if代码块 print(可以享受成年人的权利。) # 这行也属于if代码块 print(这句话无论年龄多大都会执行。) # 这行已经跳出if代码块与if同级在上面这段代码中if age 18:后面的两行print语句都比if那一行多缩进了一层通常是4个空格。Python解释器看到这个缩进就明白“哦这两行代码是只有在if条件为真时才执行的它们是一个整体代码块。”而最后一个print语句的缩进层级又和if对齐了所以它不属于if代码块会无条件执行。如果缩进错了会怎样# 错误的缩进示例 age 18 if age 18: print(你已经成年了。) # IndentationError: expected an indented block解释器会直接报错IndentationError: expected an indented block缩进错误期望一个缩进的代码块。它告诉你“我在if语句后面等着执行属于它的代码块呢你怎么没缩进就写下一句了这不合规矩。”2.2 Tab vs. 空格一场必须做出选择的战争这是Python缩进问题上最具争议性也最容易导致诡异错误的地方。Python语法允许使用Tab键或者空格来进行缩进但严禁在同一份源代码文件中混合使用两者。空格党推荐绝大多数Python社区和PEP 8Python官方编码风格指南强烈建议使用4个空格作为一级缩进。几乎所有现代代码编辑器如VS Code, PyCharm都可以设置为按Tab键时自动插入4个空格。这样做的好处是在任何编辑器、任何操作系统上查看代码的显示效果都是一致的。Tab党使用Tab字符。理论上一个Tab代表一级缩进看起来更简洁。但问题在于不同编辑器对Tab宽度的显示设置可能不同有的显示为4个空格宽度有的是8个有的是2个。在你电脑上看起来对齐的代码在别人电脑上打开可能就全乱了从而导致难以察觉的逻辑错误。我的实操心得与强制建议绝对、永远、不要混用Tab和空格。在你的编辑器里找到设置项开启“将Tab替换为空格”Replace tabs with spaces和“显示空白字符”Show whitespace功能。这样你按下的Tab键实际输入的是空格并且你能看到细微的空格点·和Tab箭头→从根本上杜绝混用问题。这是新手避免IndentationError最有效的一招。2.3 多级缩进与常见结构随着逻辑复杂代码会有多级缩进。理解每一级缩进对应的逻辑层级是关键。# 多级缩进示例if-elif-else 嵌套 score 85 if score 90: grade A if score 95: # 第二级缩进属于第一个if的代码块内的另一个if remark 优秀 else: remark 良好 elif score 60: # 与第一个if同级 grade C if score 75: # 第二级缩进属于elif代码块内的if grade B # 注意这里修改了grade变量 remark 及格 else: # 与第一个if、elif同级 grade D remark 不及格 print(f成绩等级{grade}, 评语{remark})注意事项一致性同一级别的代码块缩进量必须严格相同。不能第一行用4个空格第二行用5个空格。悬挂缩进对于过长的行需要换行时后续行应该缩进到与开括号如(,[,{对齐或者使用额外的缩进来区分是续行。# 对齐开括号 long_list [ item1, item2, item3, item4, item5, item6 ] # 额外缩进 result some_very_long_function_name( argument1, argument2, argument3, argument4)3. 核心语法二函数的定义与调用——封装你的代码块理解了缩进如何定义代码块函数就很好理解了。你可以把函数看作一个有名字的、可重复使用的代码块。使用函数的首要目的是避免重复DRY原则: Don‘t Repeat Yourself。3.1 定义你的第一个函数def关键字在Python中使用def关键字来定义函数。def greet(): # 函数定义开始函数名是greet括号内是参数列表这里为空 这是一个简单的问候函数 # 文档字符串用三引号包裹说明函数用途 print(Hello, there!) # 函数体缩进属于这个函数 print(How are you doing?) # 函数定义结束缩进回到与def同级关键点解析def定义函数的关键字。greet函数名遵循变量命名规则小写字母下划线见名知意。()参数列表。即使没有参数括号也不能省略。:冒号表示下面要开始写函数体了。缩进的代码块从def下一行开始所有缩进的代码都属于这个函数。文档字符串写在函数体内的第一行用三引号包裹。它不是必须的但强烈建议为每个函数编写。它可以通过help(greet)或greet.__doc__查看是重要的代码注释。3.2 调用函数让代码块执行起来定义函数只是“制作了一个工具”调用函数才是“使用这个工具”。# 定义函数 def greet(): print(Hello, there!) print(How are you doing?) # 调用函数三次 greet() print(--- 第一次问候结束 ---) greet() print(--- 第二次问候结束 ---) greet()运行这段代码你会看到Hello, there!...这段信息被打印了三次。我们只写了一次代码但通过三次调用实现了三次执行。这就是函数复用的威力。3.3 让函数更灵活参数与返回值无参函数用处有限。大多数函数需要接收外部输入参数并给出输出返回值。参数函数的“食材”def greet_person(name): # name 是形式参数简称形参 向指定名字的人问好 print(fHello, {name}!) # 在函数内部使用形参 print(How are you doing?) # 调用时提供具体的值这个值称为实际参数简称实参 greet_person(Alice) # 输出Hello, Alice! greet_person(Bob) # 输出Hello, Bob!返回值函数的“产出”函数处理完“食材”后通常需要把“菜品”送出来这就需要return语句。def add_numbers(a, b): 计算两个数的和并返回 result a b return result # 将结果返回给调用者 # return 之后的代码不会被执行 print(这行不会打印) # 调用函数并用一个变量接收返回值 sum_result add_numbers(5, 3) print(f5和3的和是{sum_result}) # 输出5和3的和是8 # 也可以直接使用返回值 print(f10和20的和是{add_numbers(10, 20)}) # 输出10和20的和是30关于return的深度理解return可以返回任意类型的值数字、字符串、列表、字典甚至是另一个函数。return可以同时返回多个值实际上它返回的是一个元组tuple。def get_circle_info(radius): area 3.14159 * radius * radius perimeter 2 * 3.14159 * radius return area, perimeter # 返回一个元组 (area, perimeter) a, p get_circle_info(5) # 元组解包分别赋值给a和p print(f面积{a:.2f}, 周长{p:.2f})return语句一旦执行会立即结束当前函数的运行并将结果返回。函数内return之后的代码都不会执行。函数可以没有return语句或者只有return没有值。这种情况下函数默认返回一个特殊值None空。4. 结合缩进与函数的综合示例与避坑指南让我们把缩进和函数结合起来看一个稍复杂的例子并分析其中常见的陷阱。4.1 示例一个简单的计算器函数def simple_calculator(num1, num2, operation): 一个简单的四则运算计算器。 参数 num1: 第一个数字 num2: 第二个数字 operation: 操作符支持 , -, *, / 返回 计算结果如果操作符不支持则返回None if operation : result num1 num2 elif operation -: result num1 - num2 elif operation *: result num1 * num2 elif operation /: if num2 ! 0: # 避免除零错误 result num1 / num2 else: print(错误除数不能为零) return None # 遇到错误提前返回None else: print(f错误不支持的操作符 {operation}) return None # 遇到错误提前返回None # 如果一切正常执行到这里并返回结果 return result # 测试函数 print(simple_calculator(10, 5, )) # 输出15 print(simple_calculator(10, 5, /)) # 输出2.0 print(simple_calculator(10, 0, /)) # 输出错误除数不能为零 None print(simple_calculator(10, 5, )) # 输出错误不支持的操作符 None这个例子体现了什么清晰的代码块结构if-elif-else构成了函数的主体逻辑每个分支下的代码通过缩进清晰地区分开。函数的封装性计算逻辑被封装在simple_calculator内部外部只需要提供数字和操作符无需关心内部如何判断和计算。错误处理在除法和非法操作符情况下函数打印错误信息并提前返回None避免了程序崩溃。4.2 避坑指南缩进与函数相关的常见错误错误1缩进不一致导致的IndentationError这是最经典的错误。检查你的编辑器是否开启了“显示空白字符”功能确保没有混用Tab和空格。错误2忘记写冒号:在def、if、elif、else、for、while、class等语句的末尾冒号是必须的。忘记冒号会报SyntaxError。错误3函数体没有正确缩进def wrong_func(): print(这行没有缩进) # IndentationError: expected an indented block所有属于函数的代码必须统一缩进一级。错误4不必要的额外缩进def mis_indented_func(): # 这行前面多了四个空格 print(函数被错误地缩进了)函数定义def应该处于模块的最顶层没有缩进。这种错误常发生在不小心把函数写在了另一个代码块如另一个函数或if语句内部。错误5return语句位置错误def get_status(score): if score 60: return 及格 # 问题如果score 60这个函数没有返回值 # 虽然Python会隐式返回None但这在逻辑上是不完整的。 # 更好的写法 def get_status_better(score): if score 60: return 及格 else: return 不及格 # 或者 return 及格 if score 60 else 不及格确保函数在所有可能的执行路径上都有明确的返回值即使是有意返回None这能使代码逻辑更清晰避免后续使用返回值时出现意外。5. 从理论到实践动手解决一个真实问题光说不练假把式。我们现在来模拟一个初学者常遇到的实际问题并用今天学的知识来解决它。问题场景你需要写一个程序读取一个包含多行数字的文本文件data.txt每一行有一个整数。你需要计算这些数字的总和、平均值并找出最大值和最小值。原始思路没有函数容易混乱# 假设data.txt内容 # 10 # 25 # 8 # 42 # 16 numbers [] with open(data.txt, r) as file: for line in file: numbers.append(int(line.strip())) if numbers: # 防止列表为空 total sum(numbers) average total / len(numbers) max_val max(numbers) min_val min(numbers) print(f总和{total}) print(f平均值{average:.2f}) print(f最大值{max_val}) print(f最小值{min_val}) else: print(文件为空或没有有效数字。)重构思路使用函数清晰可复用我们把这个任务拆分成两个函数一个负责从文件读取数据一个负责计算统计信息。def read_numbers_from_file(filename): 从指定文件中读取数字每行一个。 参数 filename: 文件名字符串 返回 包含所有数字的列表如果文件不存在或读取失败返回空列表。 numbers [] try: with open(filename, r) as file: for line in file: cleaned_line line.strip() # 去除首尾空白字符包括换行符 if cleaned_line: # 跳过空行 try: num int(cleaned_line) numbers.append(num) except ValueError: # 如果某一行不是有效整数打印警告并跳过 print(f警告跳过非数字行 {cleaned_line}) return numbers except FileNotFoundError: print(f错误找不到文件 {filename}) return [] # 返回空列表表示失败 except Exception as e: print(f读取文件时发生未知错误{e}) return [] def calculate_statistics(number_list): 计算一个数字列表的统计信息。 参数 number_list: 数字列表 返回 一个包含总和、平均值、最大值、最小值的字典。 如果输入列表为空返回None。 if not number_list: # 列表为空或None print(错误提供的数字列表为空无法计算。) return None total sum(number_list) average total / len(number_list) max_val max(number_list) min_val min(number_list) stats { 总和: total, 平均值: average, 最大值: max_val, 最小值: min_val } return stats # 主程序逻辑变得非常清晰 def main(): filename data.txt numbers read_numbers_from_file(filename) if numbers: # 只有成功读取到数字才进行计算 stats calculate_statistics(numbers) if stats: # 确保计算成功 print( 统计结果 ) for key, value in stats.items(): if key 平均值: print(f{key}: {value:.2f}) else: print(f{key}: {value}) # 执行主程序 if __name__ __main__: main()这样做的好处模块化每个函数只做一件事。read_numbers_from_file只管读文件和处理格式calculate_statistics只管计算。逻辑清晰易于理解和调试。可复用性calculate_statistics函数现在可以用于任何数字列表不仅限于从文件读取。read_numbers_from_file函数稍加修改也可以用来读其他格式的数据。错误处理两个函数内部都包含了基本的错误处理文件不存在、非数字内容、空列表等使主程序main非常干净健壮。可测试性你可以很容易地为每个函数单独编写测试代码而不用操作真实的文件。通过这个例子你应该能体会到将代码用函数组织起来并配合清晰的缩进是如何让一个脚本从“勉强能用”变得“结构清晰、健壮可靠”的。这正是Python基础语法赋予我们的构建复杂程序的能力起点。