在编写 Python 代码时,注释(Comments)是给写给自己和同事看的“情书”。好的注释能让代码逻辑一目了然,而糟糕的注释(或者没有注释)则是维护者的噩梦。
对于新手来说,单行注释很简单(一个 # 号搞定),但遇到需要解释一大段逻辑,或者临时屏蔽掉几十行代码时,“Python怎么注释多行代码?” 就成了高频问题。
本文将为你揭秘 3 种主流方法,并根据 PEP 8 官方规范 告诉你哪种才是“正规军”。

方法一:使用多个 # 号(官方推荐标准)
虽然听起来很笨,但在每一行前面加 # 实际上是 Python 官方推荐的多行注释方式。
根据 Python 的圣经 —— PEP 8 风格指南,块注释(Block Comments)应该由多个单行注释组成。
代码示例:
# 这是一个标准的块注释
# 这种方式清晰明了,不会引起歧义
# 解释:计算圆的面积
def calculate_area(radius):
return 3.14 * radius * radius
优点: * 语义清晰,编译器完全忽略。
- 符合所有 Python 代码规范检查工具(如 Flake8, Pylint)的要求。
方法二:IDE 快捷键(效率之王)
如果你觉得一行行敲 # 太累,那么利用编辑器(IDE)的快捷键是 2026 年程序员的标配操作。这也是实际工作中使用频率最高的方法。
你只需要选中你想注释的多行代码,然后按下:
| 编辑器/IDE | Windows 快捷键 | Mac 快捷键 |
|---|---|---|
| VS Code | Ctrl + / |
Cmd + / |
| PyCharm | Ctrl + / |
Cmd + / |
| Sublime Text | Ctrl + / |
Cmd + / |
| Jupyter Notebook | Ctrl + / |
Cmd + / |
操作演示:
- 鼠标拖拽选中 10 行代码。
- 按下
Ctrl + /。 - 瞬间,这 10 行代码前面都会自动加上
#。 - 再按一次,自动取消注释。
方法三:使用三引号 ''' 或 """(不仅是注释)
很多新手教程会告诉你:用三个单引号或三个双引号把代码包起来,就是多行注释。
代码示例:
"""
这是一个由三引号包裹的区域
看起来像多行注释
但它本质上是一个字符串
"""
print("Hello World")
⚠️ 专家借一步说话: 严格来说,这并不是真正的注释。在 Python 中,这被称为 文档字符串 (Docstring) 或 多行字符串常量。
- 原理: 当三引号出现在函数或类的第一行时,它是文档说明(可以通过
__doc__属性被读取)。当它出现在代码中间且未被赋值给变量时,Python 解释器会读取它但不会执行操作(相当于被“抛弃”了)。 - 缺点: 可能会产生缩进错误(IndentationError),且会被编译器解析,占用微量的内存。
- 建议: 仅在编写函数说明文档(Docstring)时使用,尽量避免用它来屏蔽代码。

4. 进阶:如何写出“靠谱”的注释?
学会了技术操作,更要懂得什么时候该写注释。
很多参加过即兴速成班的同学,往往容易养成“每一行都写注释”的坏习惯,导致代码极其啰嗦。如果你正在考虑报班系统学习,务必警惕那些教学质量低下的机构。
? 延伸阅读: 关于如何辨别培训机构的质量,这篇深度调查非常值得一读:Python 培训靠谱吗?2026年防骗避坑指南与真实就业揭秘
好的注释原则:
- 解释“为什么”而不是“是什么”: 代码本身已经告诉读者你在做什么(例如
i += 1不需要注释说“i加1”),注释应该解释为什么要这么做(例如# 修正循环边界溢出 bug)。 - 保持更新: 改了代码却不改注释,比没注释更可怕。

5. 常见问题解答 (FAQ)
Q1: Python 有像 C++ 或 Java 那样的 /* ... */ 块注释吗? A: 没有。 Python 坚持“优雅与简单”的设计哲学,没有引入这种块注释语法。请坚持使用 #。
Q2: 在 Jupyter Notebook 中怎么快速注释代码块? A: 同样支持 Ctrl + / (Windows) 或 Cmd + / (Mac)。
Q3: 哪里可以下载官方的 Python 安装包? A: 建议始终从官方渠道或可信赖的镜像站下载。您可以访问我们的主页 Python 获取最新指引。
6. 总结
在 Python 中注释多行代码,最推荐的方式是使用 IDE 的快捷键生成多个 # 号,这既符合 PEP 8 规范,又高效快捷。三引号(Docstrings)虽然可以用,但请把它们留给函数文档说明。
养成良好的注释习惯,是你从“脚本小子”进阶为“软件工程师”的第一步。