Sublime Text 缩进需三步:一关 detect_indentation 防覆盖;二配 Python.sublime-settings 覆盖语法默认值;三用 Convert Indentation to Spaces 主动转换旧制表符,否则空格设置仅对新输入生效。

Sublime Text 的 Tab 缩进不是改一个配置就能稳住的,detect_indentation 默认开启、语法专属设置硬编码、混用空格与制表符——这三者任意一个没处理好,你按 Tab 键插出来的就还是 \t,右下角显示 Spaces: 4 也纯属假象。
为什么关掉 detect_indentation 是第一步
它不报错、不弹窗、不写日志,但会在你打开任何文件的瞬间扫描前几行,把 tab_size 和 translate_tabs_to_spaces 强行覆盖成“它猜的值”。比如你刚配好全局 4 空格,一打开旧 Python 文件,右下角立刻变成 Tab Width: 2,且所有缩进快捷键都失准。
必须在 Preferences → Settings – User 中显式添加:
{
"detect_indentation": false
}
这不是可选项,是前提。没加这一行,其他所有设置都是临时生效,关掉再打开就回退。
Python 文件缩进必须单独配 Python.sublime-settings
Python 语言包自带 Python.sublime-settings,里面默认写了 "tab_size": 2 和 "translate_tabs_to_spaces": false,优先级高于用户设置,所以你在全局里写 "tab_size": 4 完全无效。
操作路径:
- 打开任意
.py文件 - 右下角点击语法名
Python→Open Syntax Specific Preferences - 在右侧 JSON 中只加这两行(不要删原有内容):
{
"tab_size": 4,
"translate_tabs_to_spaces": true
}
已打开的 .py 文件不会自动刷新,需按 Ctrl+Shift+P 输入 Reload Syntax 才生效。
Ctrl+] 和 Ctrl+[ 缩进失效的真正原因
这两个快捷键不是“无脑增减”,它们严格依赖当前视图状态:
- 右下角语法识别错误(如
.vue的<script></script>块被当成HTML)→ 缩进规则错乱 - 检测到混合缩进(
Indentation: Mixed)→Convert Indentation to Spaces菜单项灰掉,Ctrl+]会“加了又抹平” -
translate_tabs_to_spaces为false→Ctrl+]插入的是单个\t,不是 4 个空格
验证方法:打开 Settings – User 加一行 "draw_white_space": "all",保存后看 Tab 键按下去出现的是 ·(空格)还是 →(制表符)。
已有文件缩进混乱怎么安全修复
别直接 Ctrl+A + Ctrl+] —— 这会误缩字符串里的 \t、注释对齐位、YAML 键值列,导致语法错误或结构崩坏。
正确顺序:
- 先确认右下角显示
Spaces: 4(不是Tab) - 执行
View → Indentation → Convert Indentation to Spaces(若灰掉,说明检测到混用;此时开draw_white_space可视化,手动删掉几行开头的→再重试) - 再执行
View → Indentation → Reindent,让 Sublime 按当前语法结构重算层级
最常被忽略的点:所有配置只影响新输入和自动缩进,历史 \t 不会自动转。哪怕你设了 "translate_tabs_to_spaces": true,旧文件里的 \t 还是原封不动,得靠 Convert Indentation to Spaces 主动触发。











