应修改Packages/User/Preferences.sublime-settings文件,而非Settings–Default;菜单中Preferences→Settings–User打开右侧可编辑区域,确保JSON语法正确、key名准确,保存后生效。

改 Preferences.sublime-settings 就能生效,但写错位置或 key 名就白忙活——90% 的样式失效问题都出在这儿。
怎么找到并安全修改用户首选项文件
别点菜单里那个“Settings”直接编辑,它默认打开的是只读的 Default 文件。真正该改的是 Packages/User/Preferences.sublime-settings。
- 用
Preferences > Settings – User打开,这是唯一推荐路径 - 如果文件为空,直接粘贴 JSON 对象(不用加额外括号,确保是合法 JSON)
- 绝对不要改
Settings – Default或Packages/Default/下的文件,升级后会被覆盖 - Windows/macOS/Linux 路径虽不同,但通过菜单打开就自动定位,不用手动找
字体、字号、连字这些关键项怎么配才不翻车
font_face 和 font_size 看似简单,但 macOS 和 Windows 对字体名大小写、空格、引号敏感;font_options 一写错就全字体变模糊或失真。
-
"font_face": "Fira Code":必须带引号,大小写严格匹配系统已安装字体名(比如SF Mono在 macOS 上不能写成sf mono) -
"font_size": 13:12–14 是多数人舒适区间,大于 16 在高分屏上会挤占代码可视区域 -
"font_options": ["liga"]启用连字,但仅当字体本身支持(如 Fira Code、JetBrains Mono),否则无效甚至报错 - macOS 用户加
"font_options": ["gray_antialias"]可缓解次像素渲染导致的字体发虚
主题、配色方案为什么换了没反应
主题(theme)和配色(color_scheme)是两个独立字段,且路径必须指向实际存在的文件,不是插件名也不是显示名。
-
"theme": "Material-Theme-Darker.sublime-theme":后缀.sublime-theme不能省,文件得在Packages/Material Theme/目录下真实存在 -
"color_scheme": "Packages/Colorsublime/themes/One Dark.tmTheme":路径要完整,用Packages/开头,不是相对路径 - 装完主题后,务必重启 Sublime Text——部分主题依赖启动时加载资源,热重载不生效
- 如果配色看起来“灰蒙蒙”,大概率是
color_scheme指向了暗色方案但当前 theme 不支持,换配套组合(如 One Dark theme + One Dark color scheme)
项目级样式覆盖全局设置的正确姿势
每个项目需要不同缩进、不同配色?靠 .sublime-project,但它不继承用户设置,而是完全替代——这点容易被忽略。
- 执行
Project > Save Project As生成myproject.sublime-project,编辑它,在"settings"里写配置 - 项目设置优先级高于
User/Preferences.sublime-settings,所以tab_size设为 2 时,不会受全局设为 4 的影响 - 想让项目沿用大部分用户设置,只覆盖个别项?必须把所有要保留的项也复制进去,Sublime 不做“合并”,只做“替换”
- 语法专属设置(如 Python 文件用不同 tab)走
Preferences > Settings – Syntax Specific,生成Python.sublime-settings,和项目设置互不干扰
最常被漏掉的是:改完 Preferences.sublime-settings 后没保存文件,或者 JSON 格式有逗号错误——Sublime 不报错,只是静默忽略整个配置块。建议改完后用在线 JSON 校验器过一遍,再重启验证。


















