必须同时设置tab_size为4、translate_tabs_to_spaces为true并关闭detect_indentation,否则tab键仍插入\t;因前者仅控制显示与换算,后者决定输入行为,且语法专属设置和自动检测会优先覆盖全局配置。

Sublime 的 Tab 缩进不是改一个配置就能稳住的,必须同时控制 tab_size、translate_tabs_to_spaces 和 detect_indentation 三个参数,否则新开文件、切语法、重开旧文件时缩进随时“自己变”。
为什么按 Tab 还是插入 \t,不是空格?
核心问题在 translate_tabs_to_spaces 默认是 false,它不显式设为 true,tab_size 再怎么配都只影响显示宽度,和输入行为无关。更麻烦的是,这个值容易被覆盖:
-
detect_indentation默认为true,打开文件瞬间就扫描前几行,看到 \t 就强行切回 Tab 模式,右下角显示 “Tabs: 4” 就是它在生效 - Python 文件会优先读
Python.sublime-settings,里面硬编码了"tab_size": 2和"translate_tabs_to_spaces": false,你改全局设置完全无效 - 项目根目录有
.editorconfig且含indent_style = tab,EditorConfig 插件会直接劫持缩进逻辑,优先级最高
如何为 Python 文件固定 4 空格缩进?
不能只靠全局设置。必须走语法专属路径,且已打开的文件要手动刷新才生效:
- 先打开任意
.py文件 - 右下角点击语法名(如 “Python”)→ 选 Open Syntax Specific Preferences
- 在弹出的 JSON 中只保留这两项:
{"tab_size": 4,"translate_tabs_to_spaces": true} - 保存后,按
Ctrl+Shift+P输入Reload Syntax回车,让当前文件立即应用新配置
注意:文件名必须是 Python.sublime-settings,写成 Python3.sublime-settings 或 python.sublime-settings 都不生效。
已有代码缩进混乱,Convert Indentation to Spaces 为什么灰掉了?
灰色 = Sublime 检测到混合缩进(Indentation: Mixed),这是保护机制,不是 bug。它拒绝自动转换,怕错位。
直接搜替换 \t → 空格也不行——会误伤字符串、注释里的制表符,还可能把 1 个 Tab 替换成 8 个空格(取决于当前 tab_size),破坏层级。
- 先开
"draw_white_space": "all",看清哪些行开头是→(Tab)、哪些是·(空格) - 手动删掉前几行明显异常的缩进(比如某行开头是
→·→这种混搭),保存后重试命令 - 或临时切语法为
Plain Text(右下角点击→选 Plain Text),再执行Convert Indentation to Spaces,避开语法插件干扰识别 - 转完后务必再执行
Indentation: Reindent Lines,让 Sublime 按当前tab_size和translate_tabs_to_spaces重新计算整篇缩进层级
为什么改了设置,右下角还是显示 Tabs?
右下角显示 “Tabs: 4” 或 “Spaces: 4”,只反映当前视图的缩进字符类型和宽度,不代表配置已生效或历史内容已清理。它可能来自:
-
detect_indentation正在偷偷覆盖你的设置(哪怕你刚手动转完空格,下次打开又变回 \t) - 当前文件已被识别为
Makefile或其他强制用 \t 的语法,translate_tabs_to_spaces会被忽略 - 你开了
trim_automatic_white_space,保存时悄悄删掉行尾空格,导致靠空格对齐的 YAML/SQL/字典结构崩掉
最常被忽略的是:语法专属设置优先级高于全局设置,而 detect_indentation 的视图级覆盖,你根本看不到它改了什么。











