Clang-Format插件快捷键失效的根本原因是clang-format二进制路径未正确配置，需在Sublime中设置绝对路径；Windows下还需设"style": "File"并确保项目根目录打开、YAML缩进全为空格、语法识别为C++，且检查快捷键冲突。
Clang-Format插件装了但 Ctrl+Alt+F 没反应
根本原因几乎总是 clang-format 二进制找不到，不是插件没装好。插件本身不带可执行文件，只负责调用命令。
- 先在终端运行
clang-format --version，有输出才说明系统已安装；没有就别折腾 Sublime 配置 - macOS 用
brew install llvm，然后确认路径是/opt/homebrew/opt/llvm/bin/clang-format（Apple Silicon）或/usr/local/opt/llvm/bin/clang-format（Intel） - Windows 官方推荐从 LLVM releases 页面 下载预编译版，解压后路径类似
C:\Program Files\LLVM\bin\clang-format.exe - Sublime 设置里必须填
binary字段为绝对路径，不能只写clang-format；哪怕它在 PATH 里，某些 Sublime 版本仍会忽略
格式化结果和命令行不一致
这是 Windows 下高频问题：插件调用行为和直接跑 clang-format -i file.cpp 结果不同，尤其在缩进、空格、换行上。这不是 bug，是插件默认未启用完整参数协商逻辑。
- 插件默认不读取
-style=file，即使你有.clang-format文件，它可能只用内置 style 或 User Settings 里的硬编码配置 - 解决办法是把
style设为"File"（注意大小写），而不是"Custom"：{ "style": "File" } - 确保 Sublime 当前打开的是项目根目录（
Project → Open Folder），否则向上查找.clang-format会停在错误层级（比如用户主目录） - YAML 文件缩进必须全用空格，tab 会导致解析失败且无报错；字段名如
IndentWidth区分大小写，indentwidth就无效
选中代码不格式化，或保存后没自动触发
插件行为高度依赖上下文状态，不是所有操作都“即开即用”。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 选中文本时，插件只格式化选区；全文件格式化必须取消选择，再按快捷键
-
format_on_save默认是false，需手动设为true才生效；但它只对已保存文件起作用，临时 tab（无路径）不会触发 - 部分 Sublime Text 4 版本要求文件语法识别为
C++（右下角显示），识别成C或Plain Text时快捷键静默失效 - 快捷键冲突常见于输入法（如搜狗 Ctrl+Alt+F 切换输入模式）或其它插件；查键位绑定用
Preferences → Key Bindings，搜clang_format看是否被覆盖
想彻底绕过插件，直接调命令行格式化
当插件行为不可控（尤其 Windows 上反复出错），最稳的方式是自己写个 Python 命令调用 clang-format.exe，完全复现终端行为。
立即学习“C++免费学习笔记（深入）”；
- 新建插件：
Tools → Developer → New Plugin…，保存为format.py到Packages/User/ - 核心逻辑是拿到当前文件路径，执行类似
clang-format.exe -i -style=file:path/to/.clang-format file.cpp - 注意 Windows 路径含空格时，
subprocess.Popen必须用shell=True或手动加引号包裹路径，否则报错File not found - 这种方式不依赖插件内部状态，改完
.clang-format立刻生效，也不受 Sublime 工作目录影响
真正麻烦的从来不是“怎么装”，而是路径、权限、工作目录、YAML 格式、快捷键劫持这五层嵌套校验。每层漏一个，格式化就静默失败——而且没有任何提示。
