Clang-Format在Sublime Text中90%失败源于binary路径未正确配置或clang-format二进制未安装；需先通过终端运行clang-format --version验证安装，再于Settings-User中填入绝对路径（如C:Program FilesLLVMinclang-format.exe），并确保Project以Open Folder方式加载、.clang-format文件置于项目根目录且为合法YAML格式。
Clang-Format 在 Sublime Text 里跑不起来，90% 是因为 binary 路径没填对或根本没装 clang-format 二进制 —— 插件本身不带执行文件，只负责调用。
确认 clang-format 可执行文件已安装且能被调用
插件不会帮你装 clang-format，它只认命令行里能敲出来的 clang-format。先验证这个前提是否成立：
- 终端运行
clang-format --version，有输出（比如18.1.8）才算成功；没输出就说明没装或不在PATH - macOS 推荐用
brew install llvm（装完路径通常是/usr/local/opt/llvm/bin/clang-format） - Ubuntu 执行
sudo apt install clang-format（路径常为/usr/bin/clang-format） - Windows 必须从 LLVM 官方 release 页面下载完整安装包（如
LLVM-18.1.8-win64.exe），不能只下源码；安装后路径一般是C:Program FilesLLVMinclang-format.exe - 如果
clang-format不在系统PATH里，插件默认找不到，必须手动填binary字段
正确配置 Clang-Format 插件的 Settings-User
别改 Default 设置，只动 User 文件。路径是：Preferences → Package Settings → Clang-Format → Settings–User。常见错误配置包括：
-
"binary"必须是绝对路径，且 Windows 下要加.exe后缀，比如"C:\Program Files\LLVM\bin\clang-format.exe"（双反斜杠或正斜杠都行，但不能漏.exe） -
"format_on_save"设为true才能保存时自动格式化；设为false就只能手动触发 -
"style"推荐设为"file"（不是"Custom"），这样插件才会读项目根目录下的.clang-format文件 - 不要在 Settings-User 里写具体风格参数（如
IndentWidth），那些该放进.clang-format文件里
确保 .clang-format 文件被正确识别和加载
插件会从当前打开文件所在路径向上逐级查找 .clang-format 或 _clang-format，但前提是 Sublime 的工作目录得是项目根 —— 这点极易被忽略：
立即学习“C++免费学习笔记（深入）”；
- 必须通过 Project → Open Folder 打开整个项目目录，而不是单独拖一个
.cpp文件进来；否则插件可能在用户主目录甚至 Sublime 安装目录找配置文件 -
.clang-format必须是合法 YAML：缩进只能用空格（不能用 tab），字段名大小写敏感（BasedOnStyle对，basedonstyle错） - 改完
.clang-format后，插件不会热重载，需关闭再重新打开该文件，或重启 Sublime - 常见最小可用配置示例：
BasedOnStyle: Google IndentWidth: 4 UseTab: Never ColumnLimit: 100
快捷键失效或只格式化部分代码的排查要点
默认快捷键 Ctrl+Alt+F（Windows/Linux）或 Cmd+Alt+F（macOS）经常不响应，原因很具体：
- 右下角状态栏必须显示
C++，不是C、Plain Text或其他语法；点一下状态栏手动切过去 - 快捷键可能被输入法（尤其是中文输入法）、其他插件或系统全局快捷键占用；用
Ctrl+Shift+P→ 输入Preferences: Key Bindings，搜clang_format看是否有冲突项 - 插件默认只对已保存的文件生效；未保存的临时 buffer 或新建无名文件不会触发格式化
- 如果选中了某段代码再按快捷键，它只会格式化选区；全文件格式化必须取消选择后再触发
最常被跳过的环节是：没确认 Sublime 的 Project 根目录是否真对应项目根，以及 .clang-format 文件是否放在那个根目录下 —— 其他所有配置都对，这两步错一个，整个链路就断了。
