Sublime Text 默认用 Tab 缩进,需在语法专属设置中设 "translate_tabs_to_spaces": true 和 "detect_indentation": false 以强制空格缩进,再配 "tab_size": 4 符合 PEP8。

如何让 Sublime Text 默认用空格缩进而不是 Tab
Sublime Text 默认新建文件时用 tab 缩进,但多数现代项目(尤其 Python、JS、YAML)要求统一用空格。这不是靠“格式化插件”临时修,而是改掉编辑器的底层缩进行为。
关键操作是修改当前语法类型的设置,不是全局配置——因为不同语言对缩进敏感度不同(比如 Python 依赖空格层级,而 HTML 用 Tab 也无妨)。
- 打开任意
.py文件 → 菜单栏 Preferences → Settings – Syntax Specific - 在右侧窗口添加这两行(注意缩进是两个空格):
{ "translate_tabs_to_spaces": true, "detect_indentation": false } -
detect_indentation设为false很关键:否则打开已有文件时,Sublime 会强行读取文件首行缩进方式并覆盖你的设置 - 保存后,新输入的缩进自动变成空格,
Tab键也只插入空格(数量由tab_size控制)
tab_size 和 shift_width 到底该设多少
这两个参数常被混用,但作用完全不同:tab_size 决定 Tab 键插入几个空格;shift_width 只影响代码折叠、缩进对齐等 UI 行为,和实际插入字符无关。
绝大多数场景只需管 tab_size。Python 官方 PEP8 明确要求 4 空格;JS 社区主流也是 2 或 4;YAML 必须 2(缩进错一位就解析失败)。
- 在
Settings – Syntax Specific中加一行:"tab_size": 4 - 不要手动设
shift_width,除非你发现折叠线位置明显偏移(极少见) - 如果项目有
.editorconfig,Sublime 的 EditorConfig 插件会自动覆盖这些设置——此时优先信.editorconfig
为什么保存后缩进又变回 Tab 了
常见于打开已有文件时,特别是那些混合使用空格和 Tab 的旧文件。Sublime 的 detect_indentation 默认为 true,它会扫描前 200 行,只要发现任意一行以 tab 开头,就强制切换整篇为 Tab 缩进模式。
- 错误现象:
translate_tabs_to_spaces明明开了,按Tab却还是插入\t - 检查右下角状态栏:显示 “Tab Width: 4” 是正常,“Tab” 字样亮起说明当前是 Tab 模式
- 临时修复:菜单 View → Indentation → Convert Indentation to Spaces
- 根治方法:在语法专属设置里加
"detect_indentation": false,如上文所述
Python 文件缩进错位但没报错?小心 invisible 字符
Python 解析器对缩进极其敏感,但 Sublime 不会高亮显示混用的 tab 和空格。肉眼看着对齐,实际可能是 tab + 空格组合,导致 IndentationError 或逻辑错乱。
- 开启空白字符可视化:菜单 View → Whitespaces → Show Whitespaces(或设
"draw_white_space": "all") -
\t显示为浅色箭头,空格是小圆点,一眼就能揪出混用行 - 批量清理:选中代码 → Ctrl+Shift+P → 输入
Convert Indentation to Spaces回车 - 别依赖
auto_indent:它只管新行缩进,不修正已有行的隐形问题
最麻烦的不是设不对,而是设对了却没生效——往往卡在 detect_indentation 这个默认开关上,它比所有其他设置都优先级高。关掉它,才能让 translate_tabs_to_spaces 真正落地。










