package control必须先安装成功，否则所有插件（如colorhighlighter、origami等）均无法安装或生效；验证标准是ctrl+shift+p输入package control:后出现下拉命令项，且状态栏显示“successfully installed”。
Package Control 必须先装好，否则所有格式化插件都无效
没它，Ctrl+Shift+P 输 Install Package 就不会出现——这不是网络慢，是根本没注册成功。按 Ctrl+` 打开控制台，粘贴官网最新 Python 安装脚本（2026 年仍有效），回车执行；执行完必须重启 Sublime Text，再按 Ctrl+Shift+P 输入 Package Control:，能看到下拉项才算真正就位。杀毒软件可能拦截网络请求，若失败可手动下载 Package Control.sublime-package，放进 Installed Packages/ 目录（路径通过 Preferences → Browse Packages… 进入）。
JSON 格式化别用 JsFormat，优先选 Pretty JSON 或 HTML-CSS-JS Prettify
JsFormat 把 JSON 当 JS 解析：会把 null 变成字符串 "null"、删掉字符串里的反斜杠、加多余逗号——语义被悄悄改了。Pretty JSON 在 ST4 上常报 ImportError: No module named 'sublime'，因依赖旧 Python 环境；而 HTML-CSS-JS Prettify 配合正确配置反而更稳：
- 进
Preferences → Package Settings → HTML-CSS-JS Prettify → Settings - 确保写入：
"json": true（否则忽略 .json 文件）、"detect_indentation": false、"indent_size": 2、"ensure_ascii": false - 右下角状态栏必须显示
JSON（不是Plain Text或JavaScript），点击手动切换 - 文件编码必须是
UTF-8，不能是UTF-8 with BOM；若异常，用File → Reopen with Encoding → UTF-8重载
HTML/CSS/JS 格式化依赖 node.js，路径配错就静默失败
HTML-CSS-JS Prettify 底层调用 js-beautify，必须系统已安装 node 且路径正确：
- 终端运行
node --version和npm --version确认可用 - Windows 默认装在
C:\Program Files\nodejs\，macOS 用brew install node，Linux 用包管理器安装 - 进
Preferences → Package Settings → HTML-CSS-JS Prettify → Set `node` Path，填绝对路径，例如C:\Program Files\nodejs\node.exe或/usr/local/bin/node - 快捷键默认是
Ctrl+Shift+H，但只对.html/.css/.js后缀文件生效；若右下角显示不是对应语法，命令会灰显
Clang-Format 格式化 C++ 时 binary 字段不填等于白装
Clang-Format 插件本身不带二进制，只负责调用；90% 失败源于 binary 路径没设或设错：
- 先确认系统已装
clang-format：终端跑clang-format --version有输出才行 - macOS 用
brew install llvm，Ubuntu 用sudo apt install clang-format，Windows 建议从 LLVM 官网下预编译版 - 进
Preferences → Package Settings → Clang-Format → Settings，在binary字段填绝对路径，例如/usr/local/opt/llvm/bin/clang-format或C:\Program Files\LLVM\bin\clang-format.exe - 右下角语法必须为
C++（不是C或Plain Text）；未保存的临时 buffer 可能不响应；选中文本时只格式化选区
真正容易被忽略的是：每个插件都严格依赖前置条件——Package Control 是否就位、二进制是否存在、语法模式是否匹配、文件编码是否干净、路径是否绝对。少一个，命令就静默失效，连错误提示都不给。
