自定义 UI 主题必须存于 Packages/User/ 目录才不会被升级覆盖;配色方案需写完整路径如 "Packages/User/MyGreen.sublime-color-scheme";图标主题生效需确保语法识别正确、正确设置 icon_theme 和 theme 并完全重启。

自定义 UI 主题(.sublime-theme)必须存到 User 目录才不会被覆盖
Sublime Text 升级时会重写 Packages/ 下的系统自带主题文件,所以你手动改的 Material-Theme.sublime-theme 或新建的 MyCustom.sublime-theme,如果放在 Packages/Theme - Material/ 这类路径下,重启或升级后大概率消失。唯一安全位置是 Packages/User/。
操作步骤:
- Preferences → Browse Packages… → 打开
User文件夹 - 新建文件,命名为
MySkin.sublime-theme(后缀不能错) - 粘贴修改后的 JSON 内容(注意格式合法,用在线 JSON 校验器过一遍)
- 保存后,在
Settings – User中配置:"theme": "MySkin.sublime-theme" - 必须重启 Sublime Text —— 缓存不刷新,UI 无变化
配色方案(.sublime-color-scheme 或 .tmTheme)同理,路径要写全
你改完背景色、注释色,保存为 MyGreen.sublime-color-scheme,但直接写 "color_scheme": "MyGreen.sublime-color-scheme" 是无效的。Sublime 只认以 Packages/ 开头的完整路径。
正确写法:
- 文件存进
Packages/User/MyGreen.sublime-color-scheme - 设置项写成:
"color_scheme": "Packages/User/MyGreen.sublime-color-scheme" - 如果用了第三方包(比如 Dracula),路径可能是:
"color_scheme": "Packages/Dracula Color Theme/Dracula.sublime-color-scheme"—— 空格、大小写、短横都得一模一样 - 改完别急着测试,先按
Ctrl+Shift+P→ 输入Color Scheme: MyGreen看能否选中;选不中说明路径或文件名有误
图标主题(icon_theme)不生效?先确认它是不是真被加载了
A File Icon 这类图标插件不是“装完就亮”,它只对 Sublime 认得的语言后缀打图标。比如你新建一个 .env 文件,右下角显示 Plain Text,那图标根本不会渲染——不是插件坏了,是 Sublime 没把它当“可识别文件”。
解决办法:
- 打开该文件 → View → Syntax → Open all with current extension as… → 选
ShellScript或INI - 或者编辑
Packages/ShellScript/Shell-Unix-Generic.sublime-syntax,在file_extensions列表里加- env - 改完语法文件必须重启,否则图标不出现
- 检查
Settings – User是否同时写了"icon_theme"和"theme",缺一不可
改完没反应?三个地方最容易漏掉
不是代码写错了,而是 Sublime 的加载机制卡在几个固定环节:
- 没重启:所有主题、配色、图标类改动,90% 都需要完全退出再重开,仅新建窗口不够
- 拼写大小写错:
"A File Icon"写成"a file icon"或"AFileIcon",Sublime 静默忽略,无报错提示 - 语法识别失败:右下角显示
Plain Text时,任何*.sublime-settings文件都不会被读取,先手动 Set Syntax
真正麻烦的不是写配置,是 Sublime 把“生效条件”藏在多个独立模块里:UI 主题、配色方案、语法绑定、图标映射,四者互不感知。调一个,得同步盯住另外三个的状态。











