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

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

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

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），还硬用 '''，结果中间的 ' 把字符串截断

• 内容含双引号多？优先用 '''...
  • 比如：'''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 时盯着空白字符发呆。

今天关于《Python多行字符串与注释写法教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！