
Python中并没有像其他语言那样的真正“多行注释”语法,但有几种常用方式可以实现多行注释的效果。以下是整理的几种方法及其使用场景。
1. 使用三重引号字符串(推荐用于文档字符串)
虽然Python没有专门的多行注释符号,但可以用三个连续的单引号 ''' 或双引号 """ 包裹一段文本,使其成为多行字符串。当这个字符串不赋值给变量或不作为函数返回时,Python会忽略它,起到类似注释的作用。
示例:
请注意以下说明:1、本程序允许任何人免费使用。2、本程序采用PHP+MYSQL架构编写。并且经过ZEND加密,所以运行环境需要有ZEND引擎支持。3、需要售后服务的,请与本作者联系,联系方式见下方。4、本程序还可以与您的网站想整合,可以实现用户在线服务功能,可以让客户管理自己的信息,可以查询自己的订单状况。以及返点信息等相关客户利益的信息。这个功能可提高客户的向心度。安装方法:1、解压本系统,放在
"""
这是多行注释的一种写法
可以跨越多行
不会影响程序运行
"""
def my_function():
pass
注意: 这种方式本质上是创建了一个字符串字面量,并非真正的注释。如果出现在函数或类定义的开头,会被当作文档字符串(docstring),可通过 .__doc__ 访问。
立即学习“Python免费学习笔记(深入)”;
2. 每行使用 # 符号(标准注释方式)
最规范、清晰的方式是在每一行前面加上井号 #。这是官方推荐的注释方式,适用于代码说明和临时禁用代码块。
示例:
# 这是一个多行注释 # 通过每行加 # 实现 # 易读且被所有工具正确识别 x = 10 y = 20
大多数编辑器支持选中多行后使用快捷键(如 Ctrl+/)批量添加或删除 #,提升效率。
3. 不要使用的“伪注释”方式
有些人尝试用未赋值的括号或表达式包裹文本来模拟注释,例如:
( "这不是注释,而是元组中的字符串" "依然占用内存,不建议这样写" )
这种写法不仅不符合注释语义,还可能造成性能浪费或被误解析。应避免使用。
4. 编辑器技巧:块注释快捷键
虽然Python语法本身不支持 /* ... */ 类型的多行注释,但现代IDE(如PyCharm、VS Code、Sublime Text等)都支持选中多行后一键添加 #。这大大简化了多行注释的操作。
例如在 VS Code 中:
- 选中多行代码
- 按下 Ctrl + /
- 每行自动添加 # 并注释掉
基本上就这些。日常开发中,用 # 分行注释最稳妥,三重引号适合写说明文档,别混淆用途就行。










