菜单preferences → settings打开的是右侧可编辑的用户设置文件，左侧为只读默认设置；windows路径为%appdata%\sublime text\packages\user\preferences.sublime-settings，macos/linux同理但无需手动查找。
直接改用户设置文件，别碰默认设置；否则重启或升级后全丢。
Preferences → Settings 打开的是哪个文件？
菜单里点 Preferences → Settings，左侧是只读的默认设置（灰色），右侧才是你该编辑的用户设置（可写、生效）。Windows 路径在 %APPDATA%\Sublime Text\Packages\User\Preferences.sublime-settings，macOS 和 Linux 也都有对应路径，但完全不用手动找——用这个菜单打开最安全。
常见错误现象：tab_size 改了没反应、font_size 回退、汉化失效——八成是手滑写到左边去了。
- 必须只在右侧（用户设置）里写 JSON，格式要合法，少个逗号就整个设置不加载
- 改完不用重启，保存即生效（
Ctrl+S或Cmd+S） - 如果某项没生效，打开控制台（
Ctrl+`）看有没有error parsing user preferences报错
哪些基础参数建议必设？
不是所有“推荐配置”都适合你当前项目或屏幕。比如 Python 项目缩进用 4，但你硬设成 2，打开别人代码会直接报 IndentationError；4K 屏上 "font_size": 10 基本等于看不见。
-
"tab_size": 4—— 前端/Python/HTML 通用值，团队协作前提 -
"translate_tabs_to_spaces": true—— 强制空格缩进，避免混用 tab 导致 Git diff 爆炸 -
"detect_indentation": false—— 关掉自动检测，否则打开老项目时缩进会被悄悄重写 -
"font_size": 13—— 高分屏起步值，试过再调；"font_face"推荐"Consolas"或"Fira Code"（需先装字体） -
"rulers": [80, 120]—— 行长标尺，比纯靠眼睛判断更可靠
为什么改完设置有时不生效？
优先检查三类干扰源：语法特定设置、项目级设置、插件覆盖。Sublime 是“层叠式”配置，越靠近当前上下文的设置优先级越高。
- 当前文件如果是
.py，它可能读取了Python.sublime-settings（路径：Packages/User/Python.sublime-settings），里面若写了"tab_size": 2，就会覆盖全局设置 - 当前在项目里（
Project → Save Project As），且项目设置里定义了"settings"字段，也会压倒用户设置 - 某些插件（如
EditorConfig）会主动读取项目根目录的.editorconfig并强制同步缩进规则，此时 Sublime 自己的设置形同虚设
排查方法：打开控制台，输入 view.settings().get('tab_size')，看返回值是不是你预期的数字。
如何快速恢复干净的用户设置？
删掉用户设置文件内容，只留一对空花括号 {}，保存。这是最干净的起点——所有行为回归 Sublime 默认逻辑，方便你逐项加配置、确认效果。
容易被忽略的一点：很多“一键配置”脚本或教程给的 JSON 里带注释（// 这是注释），但 Sublime 的 JSON 不支持注释，粘贴进去会导致整个设置失效，连 font_size 都不认。复制前务必删掉所有 // 行。
