必须在用户设置中添加"translate_tabs_to_spaces": true、"tab_size": 4和"detect_indentation": false；右下角显示Spaces: 4才表示生效，否则仍为Tab模式，且需通过Syntax Specific为Python等语言单独配置。
Sublime Text 默认用 Tab 缩进，但 Python、YAML、JSON 等格式要求空格，直接粘贴或协作时容易报错 —— 必须全局/按项目统一设为 Tab 转空格，且要确保保存时真实写入空格而非显示为缩进。
如何确认当前文件是否已启用 Tab 转空格
右下角状态栏会显示 Tab Width: 4 或 Spaces: 4；若显示 Tab（无 Spaces 字样），说明尚未转换。点击该区域可临时切换，但不持久 —— 这只是视图设置，不影响实际保存内容。
- 真正生效要看
view.settings().get("translate_tabs_to_spaces")是否为True（可在 Sublime 控制台中运行验证） - 仅靠菜单
Convert Indentation to Spaces是一次性操作，不会改变后续输入行为 - 如果文件已有混合 Tab/空格，转换后需手动执行
Indentation → Convert Indentation to Spaces清理历史残留
全局设置 Tab 转空格（适用于大多数项目）
打开 Preferences → Settings，在右侧用户设置中添加：
{
"tab_size": 4,
"translate_tabs_to_spaces": true,
"detect_indentation": false
}
detect_indentation 设为 false 是关键：否则 Sublime 会在打开文件时自动覆盖你的设置，尤其读取含 Tab 的旧文件时会悄悄切回 Tab 模式。
-
tab_size决定按Tab键插入几个空格，常见为 2 或 4 - 设为
true时，即使你改了全局设置，打开一个以 Tab 缩进的 .py 文件，它仍会强制切回 Tab 模式并禁用translate_tabs_to_spaces - 此配置对新建文件和未识别缩进类型的文件生效，但不强制修改已有文件的实际字符
按语法类型单独配置（如 Python 强制 4 空格，Markdown 用 2）
打开 Preferences → Settings – Syntax Specific（注意：必须先用对应语法打开一个文件，比如 test.py，再调出此菜单），在右侧添加：
{
"tab_size": 4,
"translate_tabs_to_spaces": true
}
这个文件会保存为 Packages/User/Python.sublime-settings，只影响 Python 语法文件。
- 不同语言缩进规范不同：Python 官方推荐 4，JavaScript 常见 2，YAML 必须 2 且禁止 Tab
- 语法专属设置优先级高于全局设置，适合混用多语言的项目
- 如果误删了
translate_tabs_to_spaces，该语法下按Tab键会重新插入真实 Tab 字符，CI 阶段可能触发IndentationError或yaml.scanner.ScannerError
检查与修复已存在的 Tab 混乱问题
打开文件后，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Convert Indentation to Spaces 并回车 —— 这会把当前文件所有 Tab 替换为对应数量的空格，并重写缩进。
- 执行前建议先
Ctrl+Z撤销一次，确认没误操作其他内容 - 如果文件里有字符串含
\t（如日志模板），此操作不会动它们，只处理行首缩进 - 批量处理多个文件？用
Find in Files搜索^\t（正则开启），再手动逐个转换更安全；盲目全项目替换可能破坏制表符分隔的文本 - Git 提交前用
git diff --check可捕获 trailing whitespace 和 indent 错误，Sublime 插件TrailingSpaces也能高亮显示
最易被忽略的是 detect_indentation 的默认行为 —— 它像后台幽灵，悄无声息地让设置失效。关掉它，才能真正掌控缩进输出。
