必须关闭 detect_indentation 才能使 tab_size 和 translate_tabs_to_spaces 生效，否则打开文件时会静默覆盖设置；python 文件还需在语法专属设置中配置，旧文件需 reload syntax 刷新。
为什么改了 tab_size 还是插 \t？
因为 translate_tabs_to_spaces 默认是 false，只设 tab_size 只影响显示宽度，不改变 Tab 键行为。按下 Tab 仍插入制表符，不是空格。
常见现象：右下角显示 Tab Width: 4，但旁边写着 Tabs；点它手动切到 Spaces 后，关掉再打开文件又变回 Tabs。
- 必须在
Preferences → Settings – User中显式添加："translate_tabs_to_spaces": true -
tab_size是数字（如4），translate_tabs_to_spaces是布尔值（别加引号） - 如果已打开文件没反应，按
Ctrl+Shift+P输入Reload Syntax刷新当前视图
为什么 Python 文件缩进还是 2 空格？
Python 语言包自带 Python.sublime-settings，默认写死 "tab_size": 2 和 "translate_tabs_to_spaces": false。这个语法专属配置优先级高于全局设置，你改了 Settings – User 完全无效。
- 操作前提：先打开一个
.py文件，确保右下角显示Python - 菜单路径：
Preferences → Settings – Syntax Specific（该菜单仅在有语法识别时可用） - 右侧 JSON 中只加两行：
"tab_size": 4和"translate_tabs_to_spaces": true，不要删原有内容 - 保存后，已打开的
.py文件需手动Ctrl+Shift+P → Reload Syntax才生效
为什么刚配好就“失效”？detect_indentation 在偷偷覆盖
Sublime 默认开启 detect_indentation，打开文件时会扫描前几行——只要看到开头有 \t 或 2 个空格，立刻把你的 tab_size 和 translate_tabs_to_spaces 覆盖掉，状态栏右下角显示 Tabs: 4 就是它在作怪。
- 这是“视图级”覆盖，不修改配置文件，也不报错，你完全感知不到
- 解决方法：在
Settings – User中必须加一行："detect_indentation": false - 关掉后，新文件才严格按你设的规则走；旧文件需手动
Reload Syntax或重新打开 - EditorConfig 插件若存在且含
indent_style = tab，也会劫持缩进逻辑，优先级更高
已有文件缩进混乱，怎么安全转成 4 空格？
配置只影响新输入，不清理历史内容。混用 \t 和空格的文件，直接 Ctrl+A + Ctrl+] 或 Convert Indentation to Spaces 很可能误伤字符串里的 \t、破坏注释对齐，甚至导致语法错误。
- 先开可视化：
"draw_white_space": "all"加入用户设置，让\t显示为→，空格为· - 若
Convert Indentation → Convert to Spaces灰掉，说明 Sublime 检测到混合缩进（Indentation: Mixed），这是保护机制，不是 bug - 手动删掉前几行明显异常的缩进行（比如
→·→开头），保存后再试命令 - 转换完务必执行
Indentation → Reindent，否则结构层级可能未对齐
真正容易被忽略的是 detect_indentation 的静默覆盖能力——它不弹窗、不提示、不报错，只是让所有缩进配置看起来“有时灵、有时不灵”。关掉它，才是让 tab_size 和 translate_tabs_to_spaces 发挥作用的前提。
