ClangFormat插件安装失败主因是Python环境与依赖不匹配，需确认Sublime Text为Build 41xx+版本、正确安装LLVM套件并配置PATH；路径、语法类型、.clang-format文件位置及格式均影响功能生效。
ClangFormat插件装不上，Sublime Text报错Package Control: Error怎么办
多数人卡在第一步：用Package Control搜ClangFormat后安装失败，控制台弹出Package Control: Error或No module named 'clang_format'。这不是插件本身的问题，而是Python环境和依赖没对齐。
- 确认Sublime Text是Build 41xx以上版本（旧版不支持Python 3.8+，而ClangFormat插件已弃用Python 3.3兼容）
- 别手动下载
clang-format二进制再放系统PATH——插件会自己调用，但前提是它能找到；优先用brew install clang-format（macOS）或choco install llvm（Windows）装完整LLVM套件 - Windows用户特别注意：安装LLVM时勾选
Add LLVM to the system PATH for all users，否则Sublime启动时根本加载不到clang-format命令
装完插件但Ctrl+Shift+I没反应，怎么查配置是否生效
快捷键无效≠插件没装好，大概率是clang-format路径没配对，或者当前文件没被识别为C++类型。
- 打开
Preferences → Package Settings → Clang Format → Settings，检查"binary":字段：Linux/macOS填"clang-format"即可（确保终端里能直接运行），Windows建议写绝对路径如"C:\Program Files\LLVM\bin\clang-format.exe" - 确认当前标签页右下角显示的是
C++（不是C或Plain Text）；点一下语言名，选C++，否则插件压根不触发 - 临时测试：在空白文件里写
int main(){return 0;}，保存为test.cpp，再试格式化——扩展名比语法高亮更关键
clang-format排版结果和团队规范不一致，如何指定.clang-format文件
默认用LLVM风格，但实际项目基本都靠.clang-format文件驱动。插件支持自动读取，但有路径和优先级陷阱。
- 把
.clang-format放在项目根目录（即Sublime打开的文件夹顶层），不是源码子目录——插件只向上扫描一级 - 文件必须是YAML格式，且首行不能有BOM；常见错误是用Windows记事本保存，导致UTF-8 with BOM，ClangFormat直接静默失败
- 如果同时存在
~/.clang-format和项目内.clang-format，插件默认用项目内的；想强制全局，删掉项目文件或改Settings里的"fallback_style"为"file"
格式化后代码缩进错乱或namespace被拆成多行，是不是配置写错了
这类问题几乎全是BasedOnStyle和IndentWidth冲突导致，尤其当.clang-format里混用了Google/Chromium等风格模板。
立即学习“C++免费学习笔记（深入）”；
- 别直接复制网上“万能配置”——
BasedOnStyle: Google会覆盖后续所有缩进、空格、换行设置，除非你真按Google C++ Style Guide写代码 - 最稳做法：删掉
BasedOnStyle，手动设IndentWidth: 4、TabWidth: 4、UseTab: Never、ContinuationIndentWidth: 4 - 如果
namespace被断行，关掉AllowAllArgumentsOnNextLine: false和AllowAllParametersOfDeclarationOnNextLine: false这两项，它们会影响大括号位置判断
ClangFormat本身不维护缓存，每次格式化都实时解析配置文件；但Sublime Text的插件会缓存二进制路径和样式树，改完.clang-format后务必重启Sublime，否则旧配置还在内存里。
