Python 文件2空格转4空格方法

本文介绍在 Vim 中安全、准确地将全文件 Python 缩进从 2 空格统一升级为 4 空格的方法，通过两步 :retab 配合精确的 tabstop 和 expandtab 设置，避免破坏语法结构。

本文介绍在 Vim 中安全、准确地将全文件 Python 缩进从 2 空格统一升级为 4 空格的方法，通过两步 `:retab` 配合精确的 `tabstop` 和 `expandtab` 设置，避免破坏语法结构。

Python 对缩进高度敏感，直接使用 gg=G（自动重排版）无法可靠实现缩进宽度变更，因为它仅基于语法结构重排，而非按空格数批量替换；而粗暴的 :%s/^ //e 类正则替换又极易误伤字符串内缩进或注释内容，导致语法错误。推荐采用 Vim 原生的 :retab 命令——它专为缩进格式转换设计，能智能识别行首缩进（leading whitespace），并严格保持代码逻辑层级不变。

具体操作分两步，确保语义无损：

1. 先将现有 2 空格缩进“解释”为制表符（Tab）：

   :set noexpandtab tabstop=2
   :retab!

   :retab!（带感叹号）强制将所有匹配当前 tabstop 的行首空格序列（即每 2 个空格）转为一个 Tab 字符。注意：此步不插入真实 Tab，而是建立“2 空格 ≡ 1 Tab”的映射关系，为后续转换铺路。

2. 再将 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 协作开发中统一代码风格的可靠实践。