使用 Clang-Format 可以高效统一 C++ 项目的代码风格，实现自动化格式化。它支持高度自定义的规则配置，能集成到编辑器、IDE 或构建流程中，确保团队协作时风格一致。

1. 安装 Clang-Format

Clang-Format 是 LLVM 工具链的一部分，安装方式因系统而异：

• Ubuntu/Debian：sudo apt install clang-format
• macOS（Homebrew）：brew install clang-format
• Windows：通过 LLVM 官网下载安装包或使用 vcpkg、Chocolatey 安装

安装完成后，运行 clang-format --version 验证是否成功。

2. 创建配置文件

在项目根目录创建 .clang-format 文件，定义代码风格规则。可用命令生成默认模板：

clang-format -style=llvm -dump-config > .clang-format

常用预设风格包括：

• LLVM：LLVM 项目风格
• Google：Google C++ 风格指南
• Chromium：Chromium 项目风格
• Mozilla：Mozilla 风格
• WebKit：WebKit 项目风格

也可自定义关键选项，例如：

BasedOnStyle: Google
IndentWidth: 4
UseTab: Never
ColumnLimit: 100
AllowShortIfStatementsOnASingleLine: false
PointerAlignment: left

完整配置项参考官方文档 ClangFormatStyleOptions。

网易数帆多媒体智能生产力平台

3. 格式化代码

使用以下命令格式化单个或多个文件：

clang-format -i src/*.cpp include/*.h

• -i 表示就地修改文件
• 不加 -i 则输出到终端，用于预览

也可以只格式化 git 暂存区的更改：

git clang-format

需先安装 git-clang-format 脚本（通常随 Clang-Format 提供）。

4. 集成到开发环境

提升效率的关键是将 Clang-Format 集成到日常工具中：

• VS Code：安装 C/C++ Extension，在设置中启用 "C_Cpp.formatting": "clangFormat"，并配置保存时自动格式化。
• CLion：在 Settings → Tools → Clang-Format 启用，并指定配置文件路径。
• Vim/Neovim：配合 ale 或 neoformat 插件实现保存时自动格式化。

还可将格式化步骤加入 CI 流程，防止不符合风格的代码被提交。

基本上就这些。只要项目根目录有 .clang-format 文件，所有成员执行相同命令就能保持风格统一，减少代码审查中的格式争议。