很多开发者习惯用三引号字符串来批量屏蔽代码，但这并非真正的注释。本文从执行机制、字节码差异和文档字符串规范出发，解释为什么三引号字符串在运行时会被创建并丢弃，带来不必要的开销。通过对比 # 注释与三引号字符串的行为，明确何时该用注释、何时该用 docstring，避免混淆语义与性能。
先区分多行字符串与Python注释的本质
在Python中，注释以 # 开头，解释器在词法分析阶段会直接忽略，不会生成任何字节码。而三引号包裹的内容本质上是字符串字面量，属于Python对象。解释器会将其解析为字符串对象，如果未被赋值给变量或未被使用，它会在运行时被创建并立即被垃圾回收。语法上，注释是纯文本标记，而三引号字符串遵循字符串的转义、拼接等规则。例如，# 这是一行注释 不会占用内存，而三引号字符串会在执行时生成一个 str 实例。将两者混为一谈会导致对Python执行机制的误解，尤其在性能敏感的场景中，未使用的字符串字面量仍会带来微小的运行时开销。
验证多行字符串到底能不能当注释用
在交互式终端或脚本中，将三引号字符串独立成行放置，确实能实现屏蔽代码的视觉效果。例如在函数内部写入三引号包裹的 print 语句，由于该字符串未被赋值或调用，解释器仅创建对象后丢弃，不会触发内部逻辑。但这与注释有本质差异：若三引号字符串出现在表达式上下文中，会直接引发类型错误；而井号注释则完全不影响语法解析。此外，在模块顶层连续放置多个三引号字符串，Python会将其视为独立的语句执行，虽然不产生副作用，但会消耗解析时间。通过 dis 模块反编译可清晰看到，注释对应的字节码为空，而独立三引号字符串会生成加载常量与弹出栈顶的指令。因此，它只是未被使用的字符串，而非真正的注释。
看懂文档字符串：三引号字符串的正确用途
三引号字符串在Python中的正统身份是文档字符串。当它作为模块、类或函数的第一条语句时，Python会自动将其绑定到该对象的 __doc__ 属性上。例如定义函数并在首行编写说明文本，执行打印 __doc__ 属性即可完整输出说明内容。这与普通多行字符串不同，普通字符串若未置于首行则仅作为临时对象存在。开发者可通过内置函数 help 直接查看格式化后的文档，集成开发环境也会据此提供代码补全提示。规范编写文档字符串不仅有助于团队协作，还能被自动化工具提取生成接口文档。因此，三引号字符串的核心价值在于结构化说明，而非随意注释代码逻辑。
实际开发中如何选择：注释、docstring还是多行字符串
在实际工程中，应根据语义严格区分三者用途。若需解释某段算法逻辑、临时禁用代码或标注待办事项，必须使用单行注释，因其零运行时开销且符合官方编码规范。若需对外暴露接口说明、参数类型与返回值，应在函数或类定义首行编写文档字符串，便于自动化文档生成与编辑器集成。仅当业务确实需要处理跨行文本时，才应使用三引号多行字符串并赋值给变量。切忌用三引号字符串批量注释大段代码，这不仅会拖慢启动速度，还会导致静态分析工具误报，破坏代码可读性。遵循注释给开发者看、文档字符串给调用者看、字符串给程序用的原则，才能写出健壮且易维护的代码。
