17370845950

Python注释主要有两种：单行注释（#开头，推荐且最常用）和三重引号字符串（'''或"""，非语法注释但常作块注释或docstring）；禁用代码应逐行用#而非字符串字面量。

Python 主要有两种注释方法：单行注释和多行注释（严格来说，后者是字符串字面量，不是语法意义上的“注释”，但常被用作块注释）。

单行注释（# 号）

以 # 开头，从该符号开始到行尾的内容都会被 Python 忽略。这是最常用、最推荐的注释方式。

• 可以单独占一行，也可以写在语句末尾
• 注意：# 后面要加一个空格，提高可读性（PEP 8 建议）
• 示例：# 这是一个单行注释 或 x = 1 # 初始化计数器

多行注释（三重引号字符串）

Python 没有原生的多行注释语法，但常用三重引号（''' 或 """）包裹一段字符串，不赋值、不引用，Python 解释器会忽略它——效果等同于多行注释。

• 仅适用于不参与运行的说明性文字，不能用于临时禁用代码块（因为缩进、语法仍需合法）
• 常用于模块、函数或类的文档字符串（docstring），此时是有实际用途的
• 示例：'''这是跨多行的说明，
  不会被执行'''

不推荐的“伪注释”：用字符串字面量屏蔽代码

有人会写 "x = 2" 或 '''print("hello")''' 来“注释掉”代码，这看似可行，但有风险：

• 字符串仍会被解析（比如含语法错误会报错）
• 可能意外触发 docstring 提取（如被 help() 或 IDE 识别）
• 逻辑不清晰，易引发误解
• 真正想禁用代码，请用 # 逐行注释，或使用编辑器快捷键批量添加

基本上就这些。日常开发中，优先用 # 写单行注释；写说明性文档时，用三引号做 docstring；别用字符串“假装”注释代码。