Sublime Text需全局启用“Tab转空格”以避免语法错误和协作问题：在用户设置中添加"translate_tabs_to_spaces": true和"detect_indentation": false，并设"tab_width": 2或4；已有Tab需手动执行Convert Indentation to Spaces转换，批量处理需插件或脚本辅助。
Sublime Text 默认会用 Tab 字符缩进，但多数现代项目要求统一用空格——这不是风格偏好，而是避免混用导致的对齐错乱、Git 行变更污染、以及 Python/JSON/YAML 等语言的语法错误。
如何全局启用「Tab 转空格」
这是最基础也最关键的设置。Sublime 不会自动帮你转换已有 Tab，只对新输入生效，所以必须配合后续步骤才能真正标准化代码。
- 打开 Preferences → Settings（左侧是默认设置，右侧是用户设置）
- 在右侧用户设置 JSON 中添加或修改这两项：
"translate_tabs_to_spaces": true"detect_indentation": false -
detect_indentation设为false很重要：否则 Sublime 会根据文件首行自动切换 Tab/空格模式，导致同一项目里不同文件缩进不一致
把已有 Tab 批量转成空格
改完设置后，已存在的 Tab 不会自动变。你需要手动触发转换，且注意作用范围——是当前文件，还是整个文件夹？
- 打开目标文件 → View → Indentation → Convert Indentation to Spaces
- 快捷键更高效：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Convert Indentation to Spaces回车 - 想批量处理多个文件？目前 Sublime 原生不支持文件夹级批量转换，需借助插件（如
EditorConfig或TrailingSpaces配合正则替换），或导出为脚本用sed/python -c处理
设置缩进宽度（比如 2 空格 or 4 空格）
空格数量不统一，照样会破坏对齐和协作。不同语言社区有惯用值：Python 是 4，JavaScript 常见 2，YAML 必须 2。
- 仍在用户设置中添加：
"tab_width": 2（或4） - 该值只影响新输入和转换后的缩进宽度，不影响已有空格数量；如果文件里混着 2 格、4 格、Tab，仅靠这个设置无法修复
- 推荐配合
Indentation → Detect Indentation关闭后，再手动执行一次Convert Indentation to Spaces，确保全文件按新tab_width对齐
为什么保存后又变回 Tab？
常见于编辑器被外部工具干扰，或配置未生效。排查顺序如下：
- 检查是否误启用了
detect_indentation（设为true时，Sublime 读到首行是 Tab 就切回 Tab 模式） - 确认没有安装冲突插件，例如
SublimeCodeIntel旧版曾覆盖缩进行为 - 某些文件类型（如
.makefile）会被 Sublime 强制设为 Tab 缩进，可在右下角点击缩进标识 → Convert Indentation to Spaces 后，再点 Indentation → Detect Indentation 关闭自动识别 - 如果使用
.editorconfig，它的规则优先级高于 Sublime 用户设置，需检查indent_style = space和indent_size是否写对
真正的格式标准化不是改一个开关就结束的事——它依赖设置一致性、已有内容清理、团队配置同步，以及对特殊文件类型的持续关注。尤其当项目含多种语言或遗留代码时，单靠 GUI 操作容易漏掉角落文件。
