本文介绍在 vim 中安全、精准地将 python 源文件的 2 空格缩进批量转换为 4 空格缩进的方法，避免破坏语法结构，无需外部工具或正则误匹配。
本文介绍在 vim 中安全、精准地将 python 源文件的 2 空格缩进批量转换为 4 空格缩进的方法，避免破坏语法结构，无需外部工具或正则误匹配。
Python 对缩进高度敏感，直接使用 gg=G 会基于当前缩进逻辑“重排”而非“等比例扩缩”，极易导致语法错误（如将 elif 错位、破坏嵌套层级）。而简单查找替换（如 :%s/^ / /g）又无法处理多层缩进（如 4 空格 → 8 空格），且易误改字符串内空格或注释内容。
Vim 内置的 :retab 命令是专为此类缩进转换设计的安全方案，它仅作用于行首空白符（leading whitespace），严格区分缩进与内容，完美适配 Python 语义。其核心在于分两步利用 Tabstop 语义进行无损映射：
-
先将现有 2 空格缩进“解释”为 Tab 字符：
:set noexpandtab tabstop=2 :retab!
此时 :retab! 强制将所有匹配 tabstop=2 的前导空格（即每 2 个空格）转为一个 Tab 字符（\t），不触碰非缩进空格。
立即学习“Python免费学习笔记（深入）”；
-
再将 Tab 字符“展开”为 4 空格：
:set expandtab tabstop=4 :retab
:retab（无 !）将每个 Tab 按 tabstop=4 展开为 4 个空格，实现缩进宽度翻倍，且层级关系 1:1 保持（原 2 空格 → 1 Tab → 4 空格；原 4 空格 → 2 Tabs → 8 空格）。
✅ 优势总结：
- 完全 Vim 原生，无需插件、脚本或外部依赖；
- 仅修改缩进，绝不影响代码逻辑、字符串、注释中的空格；
- 支持任意整数倍转换（如 2→8：中间设 tabstop=2 → tabstop=8）；
- 可配合可视模式限定范围：选中后执行 :'<,'>retab! 等。
⚠️ 注意事项：
- 务必按顺序执行，且 :retab! 必须在 noexpandtab 模式下进行，否则 retab! 无效；
- 转换前建议 :w 保存或 :earlier 1f 回退，以防意外；
- 若文件混用空格与 Tab 缩进（不推荐），请先用 :set list 检查，必要时先统一为纯空格（%s/^\t\+/\=repeat(' ', len(submatch(0)))/e）再操作。
该方法已被广泛验证于 PEP 8 合规性修复及团队协作场景，是 Vim 用户处理 Python 缩进迁移最可靠、最轻量的标准实践。
