当前位置：首页 > 文章列表 > 文章 > python教程 > Python多行字符串与注释写法教程

Python多行字符串与注释写法教程

2026-04-11 22:54:53 0浏览收藏

Python中的三引号字符串（"""..."""或'''...'''）是真实可执行的字符串对象，而非注释——哪怕空着、未赋值或写在函数开头，也会被创建并带来性能与内存开销，常导致IDE警告、执行变慢甚至语法错误；正确用法需区分场景：作docstring时须紧贴def/class下一行且顶格，拼接多行文本时要警惕缩进被原样保留（可用textwrap.dedent()清理），嵌套引号需根据内容优先选用单/双三引号避免提前闭合，而与f-string组合时需注意跨行限制和运行时性能损耗；真正屏蔽代码请用#逐行注释，别误把三引号当“块注释”——细节决定成败，一个换行、一个空格、一个引号，都可能让程序悄然偏离预期。

Python长字符串怎么写_三引号多行字符串与注释用法

三引号字符串不是注释，哪怕里面没变量也不行

Python里用 """... 或 '''...''' 包起来的，只要出现在表达式或语句位置，就是字符串对象——哪怕空着、只写换行、甚至全写英文句点，它也真真实实被创建并可能被丢弃。很多人以为“没赋值就是注释”，结果在函数开头随手写一段三引号，发现函数执行变慢、内存涨了点、或者 IDE 提示“unused string literal”，就是这个原因。

常见错误现象：
• 函数体第一行写 """这是说明""" 却没加 def myfunc(): 下面的缩进，导致语法错误
• 类方法里写三引号但忘了冒号后换行缩进，直接报 IndentationError
• 把三引号当块注释用，在 if 分支中间写一段 """临时屏蔽代码"""，结果这段字符串仍被解析执行（虽然不运行，但对象已构造）

真正想注释掉多行？用 # 逐行，或选中后 Ctrl+/（多数编辑器支持）
要写文档字符串（docstring）？确保它紧贴在 def 或 class 语句下一行，且顶格或对齐（PEP 257 推荐顶格）
需要拼接长文本又不想写一堆 +？三引号是唯一干净方案，但注意缩进会原样保留——用 textwrap.dedent() 处理

缩进和换行会原样进字符串，不自动 trim

三引号字符串里的空格、Tab、换行，全算内容。你看着代码缩进整齐，打印出来却一堆前导空格，就是因为 Python 不做任何清理。

使用场景：生成 SQL、HTTP 请求体、模板片段时，格式敏感，必须控制缩进。

示例对比：

msg = """SELECT *
FROM users
WHERE active = true"""

这个 msg 开头没空格，结尾有换行；但如果你这么写：

def query():
    return """SELECT *
    FROM users
    WHERE active = true"""

那返回的字符串每行前面都有 4 个空格——因为缩进属于字符串字面量的一部分。

要保留原始缩进（比如嵌入 YAML/JSON 片段）？没问题，照写
想写得易读又不想带缩进？用 textwrap.dedent() 去掉公共前缀空格
末尾换行要不要？取决于用途：SQL 通常无所谓，但 HTTP header 值里多一个 \n 可能直接 400

`"""` 和 `'''` 完全等价，但嵌套引号时得挑着用

二者语义无差别，解释器不区分。选哪个纯看内容里有没有双引号或单引号——避免提前闭合。

常见错误现象：
• 写 SQL 时用 """SELECT * FROM t WHERE name = "Alice"""，最后一个 " 被当成字符串结束，报 SyntaxError: EOL while scanning string literal
• 字符串里含大量单引号（如英文缩写 don't, it's），还硬用 '''，结果中间的 ' 把字符串截断