Python作为一门简洁易读的编程语言，注释是代码编写过程中不可或缺的部分，多行注释能够帮助开发者对大段逻辑、函数说明或者模块功能进行清晰标注，掌握正确的多行注释方法对代码质量提升有很大帮助。
使用三引号实现多行注释
Python中最常见的多行注释方式是使用三个单引号或者三个双引号包裹注释内容，这种方式本质上是定义了一个多行字符串，如果没有被变量接收或者没有被使用，就会被解释器忽略，从而起到注释的作用。
示例代码如下：
# 三个单引号的多行注释
'''
这是第一段注释内容
这是第二段注释内容
这里可以写多行说明文字
'''
# 三个双引号的多行注释
"""
这也是多行注释的写法
支持换行书写
内容和单引号形式效果一致
"""
def test_func():
"""
这是函数的文档字符串
也可以作为多行注释使用
通常用来说明函数功能、参数和返回值
"""
pass
需要注意的是，如果三引号包裹的内容被赋值给变量，就会变成字符串对象，不再是注释，比如desc = """这是一段描述文字"""就是正常的字符串赋值操作。
使用多个单行注释拼接多行注释
除了三引号方式，还可以使用多个井号开头的单行注释拼接成多行注释，这种方式在只需要注释几行内容时比较灵活，也更符合Python的注释规范习惯。
示例代码如下：
# 这是第一行注释内容 # 这是第二行注释内容 # 这是第三行注释内容 # 多行单行注释拼接实现多行说明效果 x = 10 y = 20 # 下面是对计算逻辑的说明 # 先求和再取平均值 result = (x + y) / 2
两种多行注释方式的对比
两种多行注释方式各有适用场景，我们可以通过下面的表格来对比差异：
| 注释方式 | 适用场景 | 注意事项 |
|---|---|---|
| 三引号多行注释 | 大段说明、函数/类的文档字符串、模块说明 | 未被使用时才是注释，赋值给变量会变成字符串 |
| 多单行注释拼接 | 短段落说明、代码片段旁的多行标注 | 每行都需要加井号，修改时需要逐行调整 |
多行注释的注意事项
在使用多行注释时，有几个常见的注意点需要开发者留意：
- 三引号注释如果放在函数、类、模块的开头，会被解释为文档字符串，可以通过
__doc__属性获取，比如test_func.__doc__就能拿到函数上方的三引号内容。 - 注释内容不要写冗余的无意义内容，尽量说明代码的逻辑、用途或者特殊注意事项，提升注释的实际价值。
- 如果注释内容中包含三引号本身，需要避免和包裹注释的三引号冲突，比如用单引号三引号包裹包含双引号三引号的内容，或者反过来。
合理使用多行注释能够让代码更易于理解和维护，开发者可以根据实际的注释需求选择合适的方式，让注释真正发挥辅助阅读的作用。