Python语句、缩进与注释：清晰指南

Python语句、缩进与注释

本指南解释Python语句、统一缩进的重要性、以及如何有效使用注释和文档字符串。

解释器执行的Python指令称为语句。常见例子包括赋值语句 a = 1、控制流语句如 if、for、while。这些基础构成每个Python程序的基石。

默认换行结束语句。跨多行拆分长语句可用反斜杠（\) 行续行字符：

a = 1 + 2 + 3 + \
4 + 5 + 6 + \
7 + 8 + 9

更地道的是，Python允许在括号、方括号、花括号内隐式续行：

a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)

列表字面量也可跨行：

colors = ['red', 'blue', 'green']

也可用分号在一行放多条简单语句：

a = 1; b = 2; c = 3

不同于靠大括号的语言，Python纯靠缩进定义代码块。块在冒号后开始，在首个相对块起始未缩进的行结束。

语言允许任意一致缩进层级，社区标准是4空格。应避免制表符防混淆。

for i in range(1, 11):
    print(i)
    if i == 5:
        break

正确缩进不仅强制语法，还让代码即时可读、可维护。例如：

if True:
    print('Hello')
    a = 5

对比可读性差的单行形式：

if True: print('Hello'); a = 5

错误缩进触发 IndentationError 停止执行。

注释对文档意图和逻辑至关重要，尤其数月后重读代码。Python中注释以井号（#）开头，延伸至行尾。解释器完全忽略这些行。

# 这是注释
# 打印问候
print('Hello')

跨多行可每行加 #：

# 这是长注释
# 持续多行

或用三引号字符串作块注释。未赋值或用作文档字符串时，解释器丢弃它们，无运行时开销：

"""这是跨多行的块注释。"""

文档字符串 是紧跟函数、类、模块定义后的字符串字面量。记录元素用途，存储在 __doc__ 属性。惯用三引号：

def double(num):
    """返回输入值的两倍。"""
    return 2 * num

可程序化访问：

print(double.__doc__)

输出：

返回输入值的两倍。

更详细指南见官方文档注释和文档字符串。

Python