Python dedent 的共同缩进：看起来对齐的制表符和空格，为什么一格也没有删
把多行提示文字放进函数里的三引号字符串，前面为了源码整齐加了缩进。调用 textwrap.dedent 后，大部分模板能顶格，另一个模板却原样保留了缩进。编辑器里各行看起来齐平，不代表开头字符相同：一行用制表符，一行用空格，就可能根本没有共同的可删除前缀。
dedent 的作用是删除各个非空白行共有的行首空白，而不是按照编辑器显示宽度把每行往左推同样的距离。制表符和空格都属于它处理的缩进字符，但不会被视为可互换。下面显式写出转义字符，避免复制时编辑器偷偷转换缩进；保存为 demo.py，运行 python demo.py。
AI生成概念插图：相同可见宽度由一块长制表位与多块空格组成，字符结构并不相同；不是文本编辑器或运行截图。
from textwrap import dedent
mixed = "\talpha\n beta\n"
unchanged = dedent(mixed)
normalized = dedent(mixed.expandtabs(4))
assert unchanged == mixed
assert normalized == "alpha\nbeta\n"
print("mixed:", repr(unchanged))
print("normalized:", repr(normalized))
tabs = "\talpha\n\t\tbeta\n"
tab_result = dedent(tabs)
assert tab_result == "alpha\n\tbeta\n"
print("tab hierarchy:", repr(tab_result))
blank = " alpha\n \n beta\n"
blank_result = dedent(blank)
assert blank_result == "alpha\n\nbeta\n"
assert mixed.strip() != normalized
print("blank line:", repr(blank_result))用repr看见视觉对齐背后的字符
第一行 mixed 输出仍包含反斜杠 t 和四个空格，说明直接 dedent 没有找到共同前缀。第二行 normalized 则变成 alpha 与 beta 两行都顶格，因为先调用 expandtabs(4) 后，开头的制表符按四列制表位展开，两行才都拥有四个前导空格。改变的是输入字符，随后删除共同缩进才有明确依据。
第三组只使用制表符：第一行一个，第二行两个。dedent 会从两行各删掉一个，仍给第二行留下一个制表符。它保留了内部层级，没有把每行都简单地左侧清空。对于嵌套提示、示例步骤或者有相对对齐关系的文本，保住这个差值通常比让所有行顶格更重要。
空白行另有规则。只有空白字符的行不参与共同缩进的计算，而且会被规范成空行。示例中的空白行没有阻止前后两行删掉四个空格，输出也不再保留那行原来的空格。若你正在做逐字证据比对，这种清理本身就属于内容变化，不适合无条件应用。
展开制表符必须是有意的格式决定
expandtabs 的数字描述制表位间隔，并不表示每一个制表符永远替换成固定数量的空格。字符所在列不同，到下一个制表位所需的空格数也不同。它还会处理行中间的制表符，因此先展开再 dedent 可能同时改变正文里的列对齐；只有输入约定允许这样转换时，才应采用这个顺序。
如果模板必须原样保留制表符，比较稳妥的办法是统一模板源码的行首字符，或者把模板放进明确的资源文件，而不是在输出阶段猜它想表达几列。对于用户提交的文字，也不应因为“看着不整齐”就自动规范化；展示用途和原始记录可以各留一份，让转换边界清楚可查。
把 dedent 替换为 strip 不能解决相同问题。strip 只操作整段文本两端，不会逐行寻找共同前缀；而对每行分别 lstrip 又会删掉所有行首空白，可能把本来有意义的层级压平。选择方法时先写下允许移除的内容：整段边缘、每行全部前缀，还是全体行共有的那一段。
实用验收至少保留四种样本：全空格、全制表符、两者混合以及包含空白行。对输出用 repr 或精确字符串断言检查，再看最终界面。字体、编辑器制表宽度和网页显示规则都可能让不同字符看起来相同，视觉检查适合确认排版，却不能代替对实际文本的核对。
资料核对日期：2026年10月2日（北京时间）。示例在本地 Python 3.12.14 实际运行并通过断言，结果仅对应文中给定输入。
