必须用package control安装coolformat插件，手动复制无效；安装后需自定义快捷键、确认语法为c++、通过图形界面调整格式规则，设置保存即生效。
安装CoolFormat插件必须用Package Control
直接拖文件或手动复制插件目录基本无效，CoolFormat依赖Package Control的运行时环境。没装Package Control就先装它：按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Install Package，回车后等列表加载完成，再搜 CoolFormat 并选中安装。
常见失败点：
- 输错名字，比如写成
Cool Format或CoolFormatPlugin—— 必须严格输入CoolFormat - 网络慢导致列表卡住，可多等几秒或重试一次
Ctrl+Shift+P→Package Control: Install Package - 安装后不重启 Sublime Text 3，插件命令不会注册进命令面板
默认快捷键在多数系统上会冲突
Ctrl+Alt+Shift+Q 和 Ctrl+Alt+Shift+S 是官方默认，但 Windows/Linux 下常被输入法、远程桌面或杀毒软件拦截；macOS 上 Cmd+Alt+Shift+Q 会直接退出应用。建议立刻自定义快捷键。
操作路径：Preferences → Key Bindings，在右侧用户键绑定里加：
[
{ "keys": ["ctrl+q"], "command": "coolformat", "args": {"action": "quickFormat"} },
{ "keys": ["ctrl+shift+q"], "command": "coolformat", "args": {"action": "selectedFormat"} }
]
注意：
- 别把两个动作绑成同一个快捷键，否则选中格式化会失效
- 如果用了中文输入法，确保切换到英文状态再触发，否则可能输成全角字符
- 改完保存，不用重启，立即生效
C++格式化前必须确认语法识别为C++
CoolFormat 不自动检测语言，它只按当前文件的 syntax mode 调用对应规则。右下角状态栏显示 C、C++ 或 Plain Text 都会影响结果 —— 显示 C 时，它用 C 规则格式化 C++ 代码，括号缩进、引用符空格等全错。
强制设为 C++ 的方法：
- 右键文件 →
Set Syntax → C++ - 或按
Ctrl+Shift+P，输入sscpp（sublime 的语法速设缩写），回车 - 对新建未保存文件，先保存为
.cpp或.h后缀，syntax 通常自动匹配
顺带一提：CoolFormat 的 C++ 默认规则基于 Astyle 简化版，不支持 clang-format 那类语义级重排（比如拆分长模板参数），适合快速统一基础风格，不适合强约束项目规范。
修改格式规则要改 CoolFormat: Formatter Setting 命令
想控制花括号换行、指针星号贴左还是贴右、是否在逗号后加空格？不能改配置文件，得用插件内置命令调出图形界面设置页。
操作方式：
- 按
Ctrl+Shift+P，输入CoolFormat: Formatter Setting，回车 - 弹窗里选
C++标签页，调整滑块或勾选框（如Pointer Alignment、Add space after comma） - 点
OK保存，无需重启，下次格式化即生效
注意：这些设置存在 Packages/User/CoolFormat/FormatterSetting.sublime-settings 里，但手动编辑容易格式错误导致插件崩溃；图形界面是唯一安全入口。另外，不同语言的设置彼此隔离，C++ 改了不影响 Java。
真正麻烦的是跨平台一致性 —— Windows 用户习惯 CRLF 换行，Linux/macOS 是 LF，而 CoolFormat 默认不碰换行符。如果团队协作，得额外配 EditorConfig 或靠 Git core.autocrlf 统一，CoolFormat 本身不管这事。
