python中怎么注释多行

Python无多行注释语法，推荐用连续#号逐行注释；三引号字符串非真注释，仅用于临时屏蔽代码或写docstring，不可在逻辑中间滥用。

Python 中没有专门的“多行注释”语法，但有几种常用方式实现类似效果，关键看用途和场景。

用连续的 # 号逐行注释

这是最推荐、最清晰、最符合 Python 风格的方式。每行开头加 #，编辑器通常支持快捷键（如 Ctrl+/）一键注释/取消多行。

# 这是第一行说明
# 这是第二行说明
# 这里解释函数的作用和参数含义
def calculate_total(price, tax_rate):
    return price * (1 + tax_rate)

用三引号字符串（''' 或 """）包裹说明文字

严格来说这不是注释，而是未赋值的字符串字面量，Python 会忽略它（只要不被赋给变量或作为表达式出现）。常用于临时屏蔽大段代码，或写长文档说明（但正式文档应放在 docstring 位置）。

'''
这是临时禁用的代码块：
x = 10
y = 20
print(x + y)
'''
def greet(name):
"""这是真正的 docstring，会被 help() 和文档工具识别"""
return f"Hello, {name}"

注意：三引号不是注释，慎用于代码逻辑中

如果三引号出现在函数内部且不在首行，又没被赋值，虽然不会报错，但容易引发误解，也不利于静态检查工具识别。

立即学习“Python免费学习笔记（深入）”；

• ✅ 推荐：用多个 # 注释说明性文字或临时禁用代码
• ✅ 推荐：用 """docstring""" 写函数/模块的正式文档（放在定义后首行）
• ❌ 不推荐：在逻辑中间用三引号“假装注释”，可读性和维护性差

不复杂但容易忽略：Python 的设计哲学是“显式优于隐式”，所以明确用 # 表达注释意图，比依赖语法巧合更可靠。