必须关闭detect_indentation并配置语法专属设置,因该选项默认开启会静默覆盖tab_size和translate_tabs_to_spaces;Python文件需在Python.sublime-settings中设"tab_size": 4和"translate_tabs_to_spaces": true,且已打开文件须Reload Syntax才生效。

Sublime Text 的 Tab 缩进不是改一个设置就能管住的,它会被 detect_indentation、语法专属配置(如 Python.sublime-settings)、甚至项目级 .editorconfig 逐层覆盖。不关 detect_indentation,其他缩进设置基本形同虚设。
为什么按 Tab 还是插 \t,不是空格?
根本原因是 translate_tabs_to_spaces 默认为 false,它控制的是“按键行为”,不是显示宽度。只设 tab_size 不开这个开关,Tab 键永远插制表符。
-
tab_size是数字,translate_tabs_to_spaces是布尔值——别加引号,也别写成字符串"true" - 右下角显示
Tabs: 4或Tab Width: 4≠ 插入的是空格;只有显示Spaces: 4才说明生效 - 已打开的文件不会自动响应新设置,需手动
Ctrl+Shift+P→ 输入Reload Syntax刷新
怎么让 Python 文件统一用 4 空格?
全局用户设置对 .py 文件无效,因为 Python 语言包自带 Python.sublime-settings,默认写了 "tab_size": 2 和 "translate_tabs_to_spaces": false,优先级更高。
- 必须先打开一个
.py文件,再点菜单Preferences → Settings – Syntax Specific - 在右侧 JSON 中只加两行:
"tab_size": 4和"translate_tabs_to_spaces": true,不要删原有内容 - 如果该文件已打开且缩进混乱,
Reload Syntax后还需手动执行Convert Indentation to Spaces,否则历史 \t 仍存在
已有文件缩进混用 \t 和空格,怎么安全转换?
直接 Ctrl+A + Ctrl+] 或菜单里点 Convert Indentation to Spaces 很可能灰掉——这是 Sublime 主动保护,检测到混合缩进时拒绝自动处理。
- 先开启可视化:
"draw_white_space": "all"加到用户设置里,\t 显示为→,空格为· - 若菜单灰掉,手动删掉前几行明显混搭的缩进行首(比如
→·→),或临时切语法为Plain Text再执行转换 - 转换完务必再执行
Indentation → Reindent,否则结构层级可能没对齐 - 别开
trim_automatic_white_space处理 YAML/Markdown——它会悄悄破坏对齐
不同语言要不同缩进(比如 JS 用 2、Python 用 4),怎么隔离?
靠全局设置做不到真隔离,语法专属设置是唯一可靠路径,但要注意文件名必须严格匹配:JavaScript.sublime-settings、Python.sublime-settings,拼错一个字母就不生效。
- 每种语言都要单独打开对应后缀文件(如
app.js、main.py),再走Settings – Syntax Specific - 前端项目还可能被
.editorconfig劫持(如含indent_style = tab),EditorConfig 插件优先级高于所有 Sublime 设置 - 项目级差异大时(比如 Vue 用 2、Django 用 4),得用
.sublime-project配置,它优先级最高
真正容易被忽略的不是“怎么配”,而是 detect_indentation 的静默覆盖能力——它不报错、不提示,只在你打开文件瞬间把你的配置架空。关掉它,才是缩进可控的第一步。











