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++免费学习笔记（深入）”；
