真正原因在于detect_indentation默认开启,会扫描文件前几行并覆盖tab_size和translate_tabs_to_spaces设置;必须在用户设置中显式关闭detect_indentation,并配合语法专属配置才能生效。

tab_size 设置不生效的真正原因
改了 "tab_size": 4 却还是插出 2 格或 Tab 字符?不是配置写错了,而是 Sublime 默认开启 detect_indentation,它会偷偷扫描你打开的文件前几行,把 tab_size 和 translate_tabs_to_spaces 全部覆盖掉——右下角显示 “Tab Width: 2” 就是它在干活。
这个行为发生在“视图级”,优先级高于用户设置,也高于语法专属设置,且不会修改你的配置文件,你根本看不到它改了什么。
- 必须在
Preferences → Settings – User中显式加"detect_indentation": false -
tab_size单独设没用,必须和"translate_tabs_to_spaces": true配合,否则按 Tab 键插入的是\t,不是空格 - 新建文件缩进仍不对?说明当前语法(比如 Python)自带
Python.sublime-settings,里面硬编码了"tab_size": 2,得去Settings – Syntax Specific单独覆盖
Python 文件为什么死活不听全局设置
Python 语言包自带 Python.sublime-settings,默认 "tab_size": 2 且 "translate_tabs_to_spaces": false。你改了全局,它照旧按自己的来——这是 Sublime 的设计,不是 bug。
实操路径很明确:打开一个 .py 文件 → 点击右下角语法名(如 “Python”)→ 选 Open Syntax Specific Preferences → 在弹出的 JSON 里只留这两项:
{
"tab_size": 4,
"translate_tabs_to_spaces": true
}注意:已打开的 .py 文件不会自动刷新,得按 Ctrl+Shift+P 输入 Reload Syntax 才生效。
- 别在全局设置里写
"tab_size": 4就以为万事大吉,对.py文件基本无效 - 如果项目用 PEP 8,
translate_tabs_to_spaces必须为true,否则混用\t和空格会导致IndentationError - 语法专属配置存于
Packages/User/Python.sublime-settings,删掉它就退回到全局逻辑
怎么让空格和制表符“看得见”
缩进错乱却查不出原因?大概率是空格和 Tab 混用,但你根本看不见。Sublime 默认只显示制表符(→)和换行符(¶),·(空格)是隐藏的。
要真看清,必须在用户设置里加这一行:
"draw_white_space": "all"
这个值只接受 "none"、"selection" 或 "all",不能写成 true 或 1。
-
"draw_white_space": "all"后,所有空格(·)、Tab(→)、换行(¶)都可见,但大文件会有轻微渲染延迟 -
tab_width控制 → 的显示长度,不影响实际缩进逻辑;比如设"tab_width": 4,一个 → 就占 4 列宽 - 开了
draw_white_space还是没看到 ·?检查是否被插件(如 Pretty JSON)劫持了视图渲染
已有文件缩进混乱怎么安全修复
直接 Ctrl+A 再 Ctrl+] 是最危险的操作——它会把字符串里的 \t、注释对齐用的空格全缩进一遍,可能破坏语法。
正确流程分三步,顺序不能错:
- 先确认右下角显示
Spaces: 4(不是Tab) - 菜单执行
View → Indentation → Convert Indentation to Spaces,把所有缩进归一化为空格 - 再执行
View → Indentation → Reindent,让 Sublime 按当前语法结构重排缩进
- 如果文件顶部有
# indent:2或// vim: set ts=2 sw=2:这类注释,删掉,它们会强制覆盖设置 - EditorConfig 插件存在时,
.editorconfig里的tab_width会优先于 Sublime 设置,关插件或删配置项才能验证真实效果 - 混合缩进文件修复后,建议立刻开
"trim_automatic_white_space": true,避免保存时带多余空格
真正麻烦的从来不是设几个参数,而是 Sublime 的三层覆盖逻辑:文件头注释 > 语法专属设置 > 全局设置,而 detect_indentation 又在中间动态插一脚。调完记得看右下角,那里才是唯一真相。


















