C++如何用Clang-Format统一代码风格

Clang-Format可统一C++代码风格，支持多平台安装与配置文件定义格式规则，通过命令行或编辑器插件实现自动格式化，并能结合Git预提交钩子确保提交代码符合规范。

使用 Clang-Format 可以让 C++ 项目中的代码风格保持一致，减少人工调整格式的时间。它是一个基于 LLVM 的工具，支持通过配置文件定义代码格式规则，并能自动格式化源码。

安装 Clang-Format

在不同系统上安装方式略有不同：

安装完成后，可通过命令行输入 clang-format --version 验证是否成功。

生成配置文件

Clang-Format 使用 .clang-format 文件来定义格式规则。可以在项目根目录创建该文件，控制整个项目的格式化行为。

生成默认配置的方法：

常见配置项包括缩进宽度、换行策略、括号位置等。例如：

BasedOnStyle: Google
IndentWidth: 4
ColumnLimit: 100
AlignAfterOpenBracket: Align

手动格式化单个或多个文件

可以直接在终端中调用 clang-format 格式化指定文件：

若想递归处理整个目录，可结合 find 使用：

集成到编辑器或 IDE

大多数现代编辑器都支持 Clang-Format 插件，保存时自动格式化：

配置后，通常可以通过快捷键或“格式化文档”菜单触发。

结合 Git 使用预提交检查

防止未格式化的代码被提交，可以设置 Git 钩子（pre-commit）自动检查并格式化改动文件：

在项目中创建脚本 .git/hooks/pre-commit：

#!/bin/sh
files=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cpp\|\.h$')
for file in $files; do
    clang-format -i "$file"
    git add "$file"
done

赋予执行权限：chmod +x .git/hooks/pre-commit，这样每次提交都会自动格式化 C++ 文件。

基本上就这些。只要配置一次 .clang-format 并集成到开发流程中，团队成员就能共享统一的代码风格，减少代码审查中的格式争议。