三引号字符串是真实字符串对象而非注释,出现在语句位置即被创建;用作docstring须紧贴def/class下一行,多行文本拼接时注意缩进保留,嵌套引号需匹配,f-string与三引号组合需谨慎处理跨行和性能。

三引号字符串不是注释,哪怕里面没变量也不行
Python里用 """... 或 '''...''' 包起来的,只要出现在表达式或语句位置,就是字符串对象——哪怕空着、只写换行、甚至全写英文句点,它也真真实实被创建并可能被丢弃。很多人以为“没赋值就是注释”,结果在函数开头随手写一段三引号,发现函数执行变慢、内存涨了点、或者 IDE 提示“unused string literal”,就是这个原因。
常见错误现象:
• 函数体第一行写 """这是说明""" 却没加 def myfunc(): 下面的缩进,导致语法错误
• 类方法里写三引号但忘了冒号后换行缩进,直接报 IndentationError
• 把三引号当块注释用,在 if 分支中间写一段 """临时屏蔽代码""",结果这段字符串仍被解析执行(虽然不运行,但对象已构造)
- 真正想注释掉多行?用
#逐行,或选中后 Ctrl+/(多数编辑器支持) - 要写文档字符串(docstring)?确保它紧贴在
def或class语句下一行,且顶格或对齐(PEP 257 推荐顶格) - 需要拼接长文本又不想写一堆
+?三引号是唯一干净方案,但注意缩进会原样保留——用textwrap.dedent()处理
缩进和换行会原样进字符串,不自动 trim
三引号字符串里的空格、Tab、换行,全算内容。你看着代码缩进整齐,打印出来却一堆前导空格,就是因为 Python 不做任何清理。
使用场景:生成 SQL、HTTP 请求体、模板片段时,格式敏感,必须控制缩进。
立即学习“Python免费学习笔记(深入)”;
示例对比:
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),还硬用 ''',结果中间的 ' 把字符串截断
- 内容含双引号多?优先用
'''...
• 比如:'''He said "Hello" and left.''' - 内容含大量单引号?优先用
"""...
• 比如:"""It's fine, don't worry.""" - 实在混杂?用反斜杠转义,但别为了省事把整个字符串搞成
"\"\"\"..."——可读性崩坏
f-string 不能直接跨行,但可以和三引号组合用
你不能写 f"""hello {name} world""" 然后换行继续写——语法允许,但 f-string 的花括号只在单行解析生效。跨行 f-string 必须靠括号隐式连接,或拆成多个表达式拼接。
性能影响:f-string 在编译期就优化,比 .format() 或 % 快;但若强行塞进三引号再用 f 前缀,且里面还有复杂表达式,反而增加运行时开销(尤其重复调用时)。
- 简单插值 + 多行?直接
f"""line1 {x}\nline2 {y}"""没问题 - 需要动态缩进或条件段落?别硬塞进一个 f-string,改用
str.join()或Template.safe_substitute() - 生成配置文件?先用三引号写骨架,再用
.format()或字典替换——比嵌套 f-string 更易测、易维护
字符串本身不难,难的是边界情况:缩进是否参与内容、引号是否意外闭合、f-string 的作用域是否跨行生效。这些地方一不留神,就变成深夜 debug 时盯着空白字符发呆。










