Python注释方式详解：单行#与多行三引号的用法区别

在 Python 编程中，为代码添加说明有两种最常见的形式：井号 # 引导的单行注释，以及由成对三个单引号 ''' 或双引号 """ 包裹的多行三引号内容。表面上看，它们都能起到让代码不被常规执行、便于人类阅读的作用；但在 Python 解释器内部，二者的生命周期、处理机制与语法语义存在本质区别。本文将深入解析单行 # 与多行三引号在底层编译、内存常驻、文档挂载及工程规范中的具体差异，帮助你在开发中做出清晰且规范的选择。

一、单行 # 的本质与规范用法

井号 # 是 Python 官方语法标准中唯一的“真·注释”标记。从词法分析阶段（Lexical Analysis）开始，只要解释器遇到非字符串内部的 # 符号，该符号以及该行后续的所有字符都会被词法扫描器直接丢弃，根本不会进入抽象语法树（AST）构建环节，更不会生成任何字节码。

在日常书写中，# 主要有单行独占和行尾尾随两种排版形式：

# 计算订单最终结算金额（单行独占，通常在被说明代码上方）
subtotal = 120.0  # 基础金额（行尾尾随，建议与代码间隔至少两个空格）
discount = 0.85   # 折扣系数
final_amount = subtotal * discount

根据 PEP 8 规范，使用 # 时需注意以下细节：块注释应与被描述的代码保持相同的缩进层级；行尾注释与代码之间至少保留两个空格，# 与注释内容之间保留一个空格；避免为显而易见的代码（如 a = 1 # 变量赋值为1）添加冗余注释。

二、多行三引号的真实身份：多行字符串字面量

很多初学者常把三引号当成“多行注释语法”，但 Python 官方规范中其实并不存在“块注释语法标记”。三引号（''' 或 """）在语法上是多行字符串字面量（Multiline String Literal）。理解这一点的关键在于观察它是否被赋予变量或挂载在特定作用域上：

• 作为文档字符串（Docstring）：当紧跟在模块、类或函数定义的第一行时，Python 会在编译期自动将其捕获，并写入该对象的 __doc__ 特殊属性中，可通过 help() 函数或反射机制在运行时读取。
• 作为独立表达式语句：当三引号字符串孤立地出现在函数体或逻辑分支中间且未赋值给变量时，解释器仍会将其解析为合法的表达式语句（Expression Statement）。在字节码优化阶段，无引用的常量字符串会被丢弃，但必须严格遵守当前代码块的缩进规则。

def calculate_tax(income):
    """
    计算阶梯税率。

    参数:
        income (float): 年度应税收入。
    返回:
        float: 应缴纳的税额。
    """
    if income <= 0:
        return 0.0

    # 此处如果随意插入未对齐的三引号，会直接引发 IndentationError
    '''
    注意：在缩进块内部临时屏蔽多行代码时，
    三引号自身的每一行缩进必须与外层完全匹配。
    '''
    tax_rate = 0.1
    return income * tax_rate

# 验证 Docstring 挂载
print(calculate_tax.__doc__)

三、核心机制与关键维度深度辨析

为了在工程实践中避免混淆，我们需要从四个核心维度审视两者的关键差异：

1. 缩进敏感性与语法错误（IndentationError）

# 符号本身不需要强行与下行对齐（虽然 PEP 8 建议对齐），即使写在行首最左侧，也不会破坏代码块的缩进结构。但多行三引号作为表达式语句，其首行起始位置必须完全符合当前代码块的缩进量。如果在嵌套代码块中未对齐三引号，解释器会立即抛出 IndentationError。

2. 内存常驻与属性反射

只要三引号充当了模块、函数或类的首个非空非注释语句，它就会被编译器赋给 obj.__doc__ 变量。这意味着整个文本内容在程序运行期间都会常驻在 Python 内存的常量池与堆中。若在其中写入数万字的临时调试日志，这些文本将随程序一直占用内存；而使用 # 注释的内容在 .pyc 文件编译完毕后完全不留痕迹。

3. 转义字符与反斜杠处理

在单行注释 # C:\temp\new_file.txt 中，反斜杠 \ 只是普通文本。但在未加 r 前缀的三引号中，反斜杠是转义符号，例如 \n 会被真正转义为换行符，尾随的单斜杠甚至会改变字符串闭合逻辑，容易引发意料之外的语法解析故障。

四、常见开发误区与修正方案

在日常协作或代码审查中，经常会遇到关于两者的片面认识。我们通过具体场景进行辨析：

误区一：“在 Python 中写多行解释，只能用三引号”

辨析：这是非常普遍的误解。实际上，PEP 8 官方推荐的多行代码逻辑注释方式是连续多行使用 #。现代编辑器（如 VS Code、PyCharm）均支持快捷键 Ctrl + /（macOS 为 Cmd + /），可以瞬间批量添加或移除多行 #，既整洁又不会产生缩进风险。

# 推荐做法：通过连续的单行注释说明较为复杂的算法步骤
# 1. 对输入列表进行去重并保持原始顺序
# 2. 过滤掉所有不符合正则规则的脏数据
# 3. 将合法数据写入缓存系统

误区二：“三引号注释掉的代码绝对不会执行，所以与 # 没区别”

辨析：三引号内部虽然不会被当成 Python 语句执行，但它必须符合合法的字符串词法规范。如果在被三引号包围的旧代码中包含未转义的三引号本身，或者结尾含有单独的反斜杠，整个文件将在编译期直接崩溃：

# 错误示例：三引号内部如果刚好包含三引号，会导致提前闭合
'''
def show_sample():
    query = """SELECT * FROM users"""  # 这里的内部三引号导致解析冲突！
'''

五、操作步骤：如何规范注释与批量切换

在实际编码中，按照如下标准步骤执行注释操作，可以完全规避语法与规范问题：

六、总结与选型指南

在 Python 中，单行 # 和多行三引号并不是对立的语法替代品，而是各自承担了不同的语言职责。我们可以通过下表与总结图一目了然地厘清选型规则：