textwrap.dedent()可安全移除多行字符串的公共缩进,保留内部结构和换行符,适用于sql、json等模板生成,需配合反斜杠续行避免首行空行,不适用于docstring。

用 textwrap.dedent() 去掉多行字符串的公共缩进
Python 多行字符串(''' 或 """)会原样保留换行和空格,如果写在缩进代码块里,开头每行都会带缩进,导致字符串内容混入多余空格。这不是 bug,是设计行为——但多数人想要的是“视觉对齐 + 内容干净”。
最稳妥的做法是用 textwrap.dedent():它会自动识别并移除所有行共有的前导空白(按最小缩进量算),不破坏内部缩进结构。
- 必须先
import textwrap - 只处理字符串字面量本身,不改变变量赋值逻辑
- 对含制表符(
)的字符串效果不稳定,建议统一用空格缩进 - 不会动换行符,
仍保留,适合生成 SQL、JSON 模板等
import textwrap
<p>query = textwrap.dedent("""
SELECT id, name
FROM users
WHERE active = true
ORDER BY created_at DESC
""")三引号字符串里用 续行避免首行空行
直接写 """ 开头的多行字符串,第一行内容若从新行开始,字符串开头会多一个换行符(
)。很多人没注意,结果输出或拼接时头部多出空行。
解决方法不是删掉换行,而是用反斜杠显式续行,让字符串内容紧贴 """ 后面:
立即学习“Python免费学习笔记(深入)”;
-
"""\必须在同一行结尾,后面不能有空格 - 后续行可以正常缩进,不影响内容(配合
dedent更安全) - 这种写法对 docstring 不适用——docstring 第一行换行是规范要求
s = """ hello world""" <h1>s == 'hello world',不是 ' hello world'
别用 strip() 或 lstrip() 清理多行缩进
有人试过对三引号字符串调用 .strip() 或 .lstrip(),以为能“去缩进”,结果发现要么没用,要么把内部缩进也干掉了。
原因很简单:strip() 只删首尾的指定字符(默认空白),不碰中间;而多行字符串的“缩进”分布在每行开头,属于中间内容。
-
s.strip()最多去掉首尾换行和两端空格,对行首缩进无效 -
s.replace(' ', '')这类暴力替换会破坏真实业务数据里的空格(比如地址字段) - 正则
re.sub(r'^ +', '', s, flags=re.MULTILINE)能用,但比dedent多写、难维护、易错配制表符
Jinja2 / f-string 场景下缩进处理更敏感
模板渲染(如 Jinja2)或拼接 f-string 时,多行字符串的缩进会直接影响输出格式,尤其生成 YAML、TOML 或 HTML 片段时,缩进错一格就可能解析失败。
这时候不能只靠 dedent,还得控制模板本身的缩进风格:
- Jinja2 中用
{%-和-%}去掉模板语法周围的空白,避免注入额外换行 - f-string 里嵌套多行字符串,先
dedent再插进去,别指望 f-string 自动整理 - 用
black格式化代码时,它不会动三引号字符串内容——缩进问题得自己担着
多行字符串的缩进不是格式问题,是内容问题。哪怕看着整齐,只要没显式清理,空格就真在那儿,且在不同环境(日志、HTTP body、SQL 执行)里表现可能完全不同。










