package control必须正确加载才可安装插件：按ctrl+shift+p输入“package control: list packages”能弹出列表（哪怕为空）且状态栏显示“fetching list of available packages”才算生效；否则需检查ignored_packages设置、重启软件、手动同步仓库或重装。
Package Control 没装好，所有插件配置都白搭
插件安装的前提不是“点几下就完事”，而是 Package Control 必须正确加载并可用。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调出命令面板，输入 Package Control 后能看到一长串以 Package Control: 开头的命令，才算真正就位。如果只看到“Package Control: Install Package”但点不了、或列表空白，说明安装失败或被禁用。
- 检查
Preferences → Settings – User是否含"ignored_packages": ["Package Control"]，有就删掉 - 旧版 Sublime Text 3 若手动粘贴控制台脚本失败，别硬试——哈希校验已多次变更，直接用命令面板方式重装更稳
- 安装后不重启 Sublime，但必须重新打开命令面板验证，否则后续所有插件行为都不可信
插件配置文件路径和命名必须严格匹配
Sublime 的插件配置不是随便扔个 JSON 就生效。绝大多数插件（如 Pretty Shell、OpenInBrowser、TOML）要求用户配置写在 Packages/User/xxx.sublime-settings 文件里，且文件名必须与插件名完全一致（大小写敏感、无空格、无多余后缀）。
-
OpenInBrowser对应OpenInBrowser.sublime-settings -
Pretty Shell对应Pretty Shell.sublime-settings（注意空格，不是PrettyShell） - 路径必须是
Packages/User/，不是Packages/根目录，也不是Packages/Default/ - 文件保存为 UTF-8 编码，**禁用 BOM**；带 BOM 的 JSON 会被静默忽略，不报错也不加载
配置项填错值或漏字段，插件就“假装没看见”
很多插件依赖特定 key 的存在和合法值，填错、拼错、少写一个引号，都会导致整个配置块失效——而且 Sublime 不提示、不报错、不弹窗，只默默退回默认行为。
-
OpenInBrowser要指定 Chrome 为首选浏览器，必须同时写两行："default_browser": "chrome"和"chrome": "C:\Program Files\Google\Chrome\Application\chrome.exe"（Windows 反斜杠要双写） -
Pretty Shell的shfmt_bin_path值不能带.exe后缀，也不能是文件夹路径，必须精确到可执行文件本身 -
TOML插件装完不生效？大概率是没手动绑定.toml后缀：打开任意.toml文件 →View → Syntax → Open all with current extension as… → TOML - 所有路径中的空格无需额外转义，但反斜杠必须双写（
\），单斜杠（/）在 Windows 下多数情况也能工作，但不推荐
改完配置不刷新，等于没改
Sublime 不会自动重载用户设置。尤其语法类插件（如 TOML、Color Scheme）和菜单类插件（如 SideBarEnhancements），改完配置后常需手动触发刷新动作。
- 改了语法高亮或配色方案，按
Ctrl+Shift+P输入Reload Syntax Definitions回车 - 改了
Context.sublime-menu（侧边栏右键菜单），关闭再重开 Sublime 才能生效；仅重启窗口不够 - 改了快捷键（
Key Bindings），保存即刻生效，但若快捷键冲突（比如被系统或其他插件占用），得靠Ctrl+Alt+Shift+P查看当前作用域确认是否命中 - 验证是否真生效，别只看界面变化：对 TOML 文件，停在字符串上按
Ctrl+Alt+Shift+P应显示source.toml string.quoted.double.toml，而非text.plain
User/ 目录下的同名文件，不是你随手新建的 my-config.json；它认的是完整合法的 JSON 结构，不是看着像就行的文本块；它依赖其他前置条件（如文件已保存、扩展名小写、项目已添加到 workspace），缺一不可。这些地方不出错，配置才真正开始起作用。
