本文介绍在 Vim 中安全、准确地将全文件 Python 缩进从 2 空格统一升级为 4 空格的方法，通过两步 :retab 配合精确的 tabstop 和 expandtab 设置，避免破坏语法结构。
本文介绍在 vim 中安全、准确地将全文件 python 缩进从 2 空格统一升级为 4 空格的方法，通过两步 `:retab` 配合精确的 `tabstop` 和 `expandtab` 设置，避免破坏语法结构。
Python 对缩进高度敏感，直接使用 gg=G（自动重排版）无法可靠实现缩进宽度变更，因为它仅基于语法结构重排，而非按空格数批量替换；而粗暴的 :%s/^ //e 类正则替换又极易误伤字符串内缩进或注释内容，导致语法错误。推荐采用 Vim 原生的 :retab 命令——它专为缩进格式转换设计，能智能识别行首缩进（leading whitespace），并严格保持代码逻辑层级不变。
具体操作分两步，确保语义无损：
-
先将现有 2 空格缩进“解释”为制表符（Tab）：
:set noexpandtab tabstop=2 :retab!
:retab!（带感叹号）强制将所有匹配当前 tabstop 的行首空格序列（即每 2 个空格）转为一个 Tab 字符。注意：此步不插入真实 Tab，而是建立“2 空格 ≡ 1 Tab”的映射关系，为后续转换铺路。
立即学习“Python免费学习笔记（深入）”；
-
再将 Tab 按 4 空格展开：
:set expandtab tabstop=4 :retab
此时 :retab（无感叹号）将每个 Tab 按 tabstop=4 展开为 4 个空格。由于上一步已将原始缩进标准化为 Tab，这一步即可精准生成 4 空格缩进，且缩进层级（如 if → for → print）严格保持一致。
✅ 关键注意事项：
- 务必按顺序执行，不可颠倒或跳步；
- :retab! 是核心，它确保只处理行首缩进，忽略代码/字符串内部空格；
- 转换前建议 :w 保存或 :set backup 开启备份；
- 若文件混用空格与 Tab，先运行 :set list 检查，必要时用 :set listchars=tab:>·,trail:· 可视化定位问题。
该方法完全基于 Vim 内置功能，无需外部工具或插件，高效、可逆（反向设置即可还原），是 Python 协作开发中统一代码风格的可靠实践。
