Python多行注释的三种写法详解

Python虽无原生多行注释语法，但开发者可通过三重引号字符串（适用于文档字符串）和逐行#符号（最规范、工具友好）两种主流方式高效实现多行注释效果；文章不仅清晰对比了各方法的原理、适用场景与潜在误区（如避免用未赋值字符串模拟注释），还贴心介绍了主流编辑器的快捷键技巧，帮你写出更专业、可维护、易协作的Python代码。

Python中并没有像其他语言那样的真正“多行注释”语法，但有几种常用方式可以实现多行注释的效果。以下是整理的几种方法及其使用场景。

1. 使用三重引号字符串（推荐用于文档字符串）

虽然Python没有专门的多行注释符号，但可以用三个连续的单引号 ''' 或双引号 """ 包裹一段文本，使其成为多行字符串。当这个字符串不赋值给变量或不作为函数返回时，Python会忽略它，起到类似注释的作用。

示例：

"""
这是多行注释的一种写法
可以跨越多行
不会影响程序运行
"""
def my_function():
    pass

注意： 这种方式本质上是创建了一个字符串字面量，并非真正的注释。如果出现在函数或类定义的开头，会被当作文档字符串（docstring），可通过 .__doc__ 访问。

2. 每行使用 # 符号（标准注释方式）

最规范、清晰的方式是在每一行前面加上井号 #。这是官方推荐的注释方式，适用于代码说明和临时禁用代码块。

示例：

# 这是一个多行注释
# 通过每行加 # 实现
# 易读且被所有工具正确识别
x = 10
y = 20

大多数编辑器支持选中多行后使用快捷键（如 Ctrl+/）批量添加或删除 #，提升效率。

3. 不要使用的“伪注释”方式

有些人尝试用未赋值的括号或表达式包裹文本来模拟注释，例如：

(
"这不是注释，而是元组中的字符串"
"依然占用内存，不建议这样写"
)

这种写法不仅不符合注释语义，还可能造成性能浪费或被误解析。应避免使用。

4. 编辑器技巧：块注释快捷键

虽然Python语法本身不支持 /* ... */ 类型的多行注释，但现代IDE（如PyCharm、VS Code、Sublime Text等）都支持选中多行后一键添加 #。这大大简化了多行注释的操作。

例如在 VS Code 中：

• 选中多行代码
• 按下 Ctrl + /
• 每行自动添加 # 并注释掉

基本上就这些。日常开发中，用 # 分行注释最稳妥，三重引号适合写说明文档，别混淆用途就行。

本篇关于《Python多行注释的三种写法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！