Clang-Format需正确配置预设风格（如-google）并生成.clang-format文件，配合git差分格式化、IDE配置对齐及注释开关，才能安全使用；它仅处理换行缩进等基础格式，不覆盖代码审查规则。
Clang-Format 不是“装了就能用”的工具，它默认配置和主流风格（如 Google、LLVM、Chromium）差异明显，直接运行 clang-format -i 很可能把代码格式越弄越乱，甚至破坏可读性或引入编译错误。
怎么选对 .clang-format 配置文件？
别手写 YAML —— 90% 的人卡在这一步。Clang-Format 提供官方生成器：clang-format -dump-config 输出当前默认配置，但没参考价值；真正该用的是：clang-format -style=google -dump-config > .clang-format。支持的预设风格包括：google、llvm、chromium、mozill a、webkit。
-
google：适合内部项目，缩进 2 空格、函数参数每行一个、指针符号紧贴类型（int* p） -
llvm：Clang 自身风格，缩进 2 空格但允许长行不换行，*和&紧贴变量名（int *p） - 自定义时优先改
IndentWidth、PointerAlignment、AllowAllArgumentsOnNextLine这几个关键项，其他保持默认
怎么让 clang-format 只格式化改动部分？
全量格式化容易引发大量无关 diff，尤其在团队协作中。用 Git 配合 clang-format 是更安全的做法：
- 格式化暂存区中的 C++ 文件：
git diff -U0 --no-color --cached -- '*.cpp' '*.h' '*.cc' '*.hh' | clang-format-diff -p1 -i - 格式化某次 commit 修改的代码：
git show -s --format=%H HEAD~1 | xargs -I {} git diff -U0 --no-color {} -- '*.cpp' '*.h' | clang-format-diff -p1 -i - 确保
clang-format-diff已安装（通常随 clang 一起提供，macOS 上brew install clang-format即包含）
为什么 clang-format 有时会删掉空行或合并 if/else？
这是 BreakBeforeBraces 和 AllowShortIfStatementsOnASingleLine 等规则生效的结果，并非 bug。例如：
立即学习“C++免费学习笔记（深入）”；
if (x) {
foo();
}在 google 风格下会被强制改成：
if (x) { foo(); }- 若要禁用短语句单行化，显式设置
AllowShortIfStatementsOnASingleLine: false - 空行控制靠
BlankLineBeforeNamespace、KeepEmptyLinesAtTheStartOfBlocks，不是所有版本都支持，Clang 14+ 更稳定 - 某些宏（如
DISALLOW_COPY_AND_ASSIGN）会被误判为函数声明，可在其前后加// clang-format off/// clang-format on
VS Code 或 CLion 里怎么避免配置冲突？
IDE 内置的 Clang-Format 支持常忽略项目根目录下的 .clang-format，尤其当全局设置启用了 “Format on Save” 却没指定 style path。
- VS Code：检查
settings.json中是否设置了"C_Cpp.clang_format_style": "file"（必须是file，不是Google字符串） - CLion：Settings → Editor → Code Style → C/C++ → Scheme → Manage → Import Scheme → Clang-format style file，指向项目内
.clang-format - 如果 IDE 格式化结果和命令行不一致，大概率是它读到了别的配置（比如用户目录下的
~/.clang-format），用clang-format -dump-config -verbose可查实际加载路径
最常被忽略的一点：Clang-Format 不处理头文件包含顺序、using 声明位置、命名规范（如 kConstantName）或注释风格 —— 它只管“怎么换行、缩进、空格”，别指望它替代代码审查规则。
