python多行注释的方法整理-Python教程-PHP中文网

python多行注释的方法整理

冷炫風刃

发布： 2025-10-18 21:28:01

原创

1059人浏览过

python多行注释的方法整理

Python中并没有像其他语言那样的真正“多行注释”语法，但有几种常用方式可以实现多行注释的效果。以下是整理的几种方法及其使用场景。

虽然Python没有专门的多行注释符号，但可以用三个连续的单引号 ''' 或双引号 """ 包裹一段文本，使其成为多行字符串。当这个字符串不赋值给变量或不作为函数返回时，Python会忽略它，起到类似注释的作用。

示例：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

"""
这是多行注释的一种写法
可以跨越多行
不会影响程序运行
"""
def my_function():
    pass

登录后复制

注意： 这种方式本质上是创建了一个字符串字面量，并非真正的注释。如果出现在函数或类定义的开头，会被当作文档字符串（docstring），可通过 .__doc__ 访问。

最规范、清晰的方式是在每一行前面加上井号 #。这是官方推荐的注释方式，适用于代码说明和临时禁用代码块。

示例：

# 这是一个多行注释
# 通过每行加 # 实现
# 易读且被所有工具正确识别
x = 10
y = 20

登录后复制

大多数编辑器支持选中多行后使用快捷键（如 Ctrl+/）批量添加或删除 #，提升效率。

有些人尝试用未赋值的括号或表达式包裹文本来模拟注释，例如：

(
"这不是注释，而是元组中的字符串"
"依然占用内存，不建议这样写"
)

登录后复制

这种写法不仅不符合注释语义，还可能造成性能浪费或被误解析。应避免使用。

虽然Python语法本身不支持 /* ... */ 类型的多行注释，但现代IDE（如PyCharm、VS Code、Sublime Text等）都支持选中多行后一键添加 #。这大大简化了多行注释的操作。

例如在 VS Code 中：

基本上就这些。日常开发中，用 # 分行注释最稳妥，三重引号适合写说明文档，别混淆用途就行。

以上就是python多行注释的方法整理的详细内容，更多请关注php中文网其它相关文章！

大家都在看：