Python / 系统课时

看懂缩进、注释和代码块

看懂缩进、注释和代码块

本篇解决 Python 初学者最容易遇到的格式问题:为什么缩进会影响程序结构,以及如何使用注释提高代码可读性。完成学习后,你可以正确组织代码块并避免常见缩进错误。

学习目标

  • 理解 Python 使用缩进表示代码层级的规则。
  • 学会编写单行注释并说明代码意图。
  • 能够识别常见缩进错误并进行修正。

Python 为什么要求缩进

很多编程语言使用大括号表示代码块,例如 {}。Python 选择使用缩进表示代码所属层级,让代码结构直接体现在排版中。

下面代码中,if 后面的缩进代码属于条件成立时执行的代码块:

python
age = 18

if age >= 18:
    print("可以访问")

预期输出

text
可以访问

冒号 : 表示后面会开始一个新的代码块,而下一行开始的缩进决定哪些语句属于这个代码块。

掌握缩进规则

Python 对缩进数量没有强制要求必须是某个固定数字,但同一个代码块必须保持一致。实际开发中通常使用 4 个空格作为一级缩进。

正确示例:

python
score = 90

if score >= 60:
    print("及格")
    print("可以进入下一阶段")

错误示例:

python
score = 90

if score >= 60:
  print("及格")
    print("缩进不一致")

第二个 print 与前一个语句的缩进层级不同,Python 会报告缩进错误。

使用注释说明代码

注释是写给开发者阅读的信息,不会被 Python 执行。单行注释使用 # 开头。

python
# 保存用户年龄
age = 20

print(age)

预期输出

text
20

好的注释应该解释代码为什么这样写,而不是重复描述代码本身。例如变量名已经表达含义时,不需要添加“给 age 赋值 20”这种重复注释。

常见格式错误处理

初学者通常会遇到以下问题:

问题 原因 处理方式
IndentationError 缩进层级错误 检查空格数量和层级
TabError 混用了 Tab 和空格 统一编辑器缩进设置
代码块提前结束 缩进减少 调整代码层级

编辑 Python 文件时,建议开启编辑器的空格显示功能,避免隐藏的 Tab 和空格混用。

理解缩进后,阅读 Python 代码时应优先观察代码层级,而不是只看关键字。缩进本身就是 Python 程序结构的一部分。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂缩进、注释和代码块

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通