必须同时设置"tab_size":4和"translate_tabs_to_spaces":true,否则按tab键仍插入\t导致python/yaml报错;还需禁用"detect_indentation":false防覆盖,并确保color_scheme路径准确、大小写敏感。

Sublime Text 的首选项不是堆参数就能变好用,而是要精准解决你此刻正卡住的问题:缩进错乱、字体发虚、主题不生效、保存后换行崩掉……改对几个关键项,比全量复制别人配置管用十倍。
tab_size 和 translate_tabs_to_spaces 必须成对设
只改 tab_size 不改 translate_tabs_to_spaces,按 Tab 键照样插 \t,Python 或 YAML 一运行就报 IndentationError。这两个值是联动的:
-
tab_size只控制显示宽度和视觉对齐,不影响实际插入字符 -
translate_tabs_to_spaces才决定按 Tab 键时插的是空格还是制表符 - Python/JS/HTML 项目建议设为
{"tab_size": 4, "translate_tabs_to_spaces": true} - Shell 脚本或 Makefile 若依赖真实
\t,必须设"translate_tabs_to_spaces": false - 加
"detect_indentation": false可禁用自动探测,避免打开他人文件时被覆盖
color_scheme 路径写错主题就白配
复制别人配置里的 color_scheme 值,90% 情况下主题不生效——因为路径指向他本地硬盘。Sublime 只认三种格式,且后缀敏感:
- 内置主题:必须以
Packages/开头,如"Packages/Color Scheme - Default/Monokai.sublime-color-scheme" - 用户自定义主题:放
Packages/User/下,路径写成"Packages/User/MyScheme.sublime-color-scheme"(新版推荐.sublime-color-scheme,旧版用.tmTheme) - 绝对路径(不推荐):Windows 用
file:///C:/...,macOS/Linux 用file:///Users/xxx/...,换机器就失效 - 路径大小写必须精确,
monokai和Monokai是两个东西
font_face 和 font_options 连字支持要看真本事
启用了 liga 却没效果?不是配置错了,是字体或系统不支持:
- Fira Code、JetBrains Mono 支持连字;Consolas、Courier New 不支持
- macOS 默认支持;Windows 需开启 ClearType 并确保 Sublime 启动时能读到字体路径
- 字体名含空格(如
IBM Plex Mono)必须用双引号包裹,不能写成IBM\ Plex\ Mono - Linux 下可能需手动安装字体并刷新缓存:
fc-cache -fv -
"subpixel_antialias": true在非 Retina 屏上常导致文字发虚,建议删掉或留空数组
ignored_packages 禁用插件要重启才生效
在 ignored_packages 里删掉某个插件名,结果它还在跑?常见原因有三个:
- 大小写必须完全一致:
"Git"≠"git"≠"GIT" - 插件名不是文件夹名,比如
Package Control对应的文件夹是Package Control,但有些插件名带空格或连字符,得去Packages/目录下确认 - 改完必须重启 Sublime,热重载不触发插件卸载逻辑
- 如果想临时禁用,用命令面板输入
Package Control: Disable Package更稳妥
真正麻烦的从来不是“怎么配”,而是“为什么配了没用”——路径大小写、后缀类型、重启要求、字体底层支持,这些细节不盯住,再全的配置清单也救不了现场。











