Preferences → Settings 打开的是 Packages/User/Preferences.sublime-settings（User），右侧为可编辑用户设置，左侧为只读默认设置；必须修改右侧，否则升级会被重置。
Preferences → Settings 打开的是哪个文件？
打开 Preferences → Settings，右侧窗格就是你该改的 Preferences.sublime-settings（User），左侧是只读的 Default。改错地方是失效第一大原因——有人手滑点了左侧编辑再保存，结果升级后全丢；也有人直接去 Packages/Default/Preferences.sublime-settings 里硬改，这文件每次更新都会被覆盖。
正确路径在：Packages/User/Preferences.sublime-settings（macOS 和 Windows 路径一致，Sublime 自动定位）。用菜单打开最稳，别手动找文件。
tab_size 和 translate_tabs_to_spaces 怎么配才不打架？
这两个必须一起设，否则缩进行为会反复横跳。比如你设了 tab_size 为 2，但没关 detect_indentation，一打开老项目它就自动切回 4；或者开了 translate_tabs_to_spaces 却没设 tab_size，按 Tab 键插出来的空格数可能和你预期不符。
"tab_size": 2"translate_tabs_to_spaces": true-
"detect_indentation": false（关掉自动探测，让设置真正生效）
注意：tab_width 是旧版键名，2026 年已弃用，写它无效；必须用 tab_size。
字体模糊、中文乱码、行高不匀？关键参数不是 font_face
单纯换 font_face 很难解决显示问题。macOS 上 "font_options": ["gray_antialias"] 能缓解字体发虚；Windows 下读老旧文本常乱码，加 "fallback_encoding": "UTF-8 with BOM" 更稳；行距不均多半是 line_padding_top / line_padding_bottom 没设，建议都设成 1 或 2。
另外：font_size 别设低于 12，尤其外接高分屏；font_face 值大小写敏感（如 "SF Mono" 不能写成 "sf mono"），且必须加引号。
color_scheme 和 theme 路径写错就白配
主题和配色方案路径必须严格匹配实际位置。内置主题路径形如 "theme": "Adaptive.sublime-theme"；自定义主题或配色放 Packages/User/ 下时，路径要写全："color_scheme": "Packages/User/MyScheme.tmTheme"。漏掉 Packages/User/ 前缀，或大小写错一个字母（比如 monokai.tmtheme 写成 Monokai.tmTheme），主题就加载失败，界面还是默认灰。
验证方法：打开 Preferences → Color Scheme 或 Theme 菜单，看你的选项是否出现在列表里。没出现，八成是路径或文件名错了。
最容易被忽略的其实是 ignored_packages 的大小写和重启要求——禁用 "Vintage" 写成 "vintage" 不生效，改完必须重启 Sublime 才能卸载插件。配置不是写完就跑，得对路、对名、对时机。
