必须关闭detect_indentation并设置tab_size和translate_tabs_to_spaces,否则按Tab仍插\t;因detect_indentation默认true,会静默覆盖用户配置,Python等语言还需语法专属设置并Reload Syntax生效。

Sublime Text 里改 tab_size 不等于缩进就变,必须同时关掉 detect_indentation 并打开 translate_tabs_to_spaces,否则按 Tab 键插的还是 \t,右下角显示的宽度只是“看起来像”,不是实际字符。
为什么改了 tab_size 没效果?
因为 detect_indentation 默认为 true,它会在你打开文件时偷偷扫描前几行,把 tab_size 和 translate_tabs_to_spaces 全部覆盖成它“猜”的值——比如一个用 2 空格缩进的 Python 文件,打开后立刻变成 tab_size: 2、translate_tabs_to_spaces: false,哪怕你用户配置里写的是 4 和 true。
- 右下角状态栏显示
Detect Indentation或Tab Width: X旁边写着Tabs,说明正在被自动接管 - 这个覆盖不报错、不提示,也不改你的配置文件,你完全感知不到
- 临时点右下角切换
Convert Indentation to Spaces只对当前文件生效,关掉重开又回退
全局设置要关 detect_indentation 才真正生效
在 Preferences → Settings – User 的 JSON 中,必须明确加这三行:
{
"detect_indentation": false,
"tab_size": 4,
"translate_tabs_to_spaces": true
}
-
detect_indentation: false 是前提,不加这句,其他都白配 -
tab_size控制按 Tab 键插入几个空格,也控制显示宽度 -
translate_tabs_to_spaces: true 才让 Tab 键输出空格;设为 false 时,哪怕tab_size是 4,按 Tab 插入的仍是单个\t字符
Python 文件必须单独配语法专属设置
Python 语言包自带硬编码的 Python.sublime-settings,默认是 "tab_size": 2 和 "translate_tabs_to_spaces": false,会直接无视你的全局配置。
- 打开任意
.py文件 → 右下角点击Python→ 选Open Syntax Specific Preferences - 在弹出的 JSON 中只留这两项:
{ "tab_size": 4, "translate_tabs_to_spaces": true } - 已打开的 .py 文件不会自动刷新,需按
Ctrl+Shift+P输入Reload Syntax才生效
怎么验证当前插入的是空格还是制表符?
光看缩进对齐没用,得确认实际字符。最可靠的方法是开启空白符可视化:
- 在用户设置中加一行:
"draw_white_space": "all" - 保存后,空格显示为小圆点(·),制表符显示为箭头(→)
- 按一次 Tab 键,如果出现四个 ·,说明配置生效;如果出现一个 →,说明
translate_tabs_to_spaces没起作用,或被语法设置/EditorConfig 覆盖了
真正容易被忽略的是 detect_indentation 的静默覆盖行为——它不改配置、不发警告,只在你打开文件那一瞬间就把你的设置“架空”。关不掉它,其他所有缩进配置都是纸面功夫。











