Clang-Tidy是LLVM项目旗下的静态分析工具，专门针对C++代码设计，既可以检查代码中的潜在错误，也能按照指定的编码规范对代码风格进行校验，是提升C++项目代码质量的高效工具。它不需要运行代码，仅通过解析代码的语法和语义就能完成分析，适合集成到开发流程的各个阶段。
Clang-Tidy的安装方法
不同操作系统的安装方式略有差异，以下是常见系统的安装步骤：
- Ubuntu/Debian系统：可以直接通过apt包管理器安装，执行命令
sudo apt install clang-tidy即可完成安装。 - macOS系统：使用Homebrew包管理器，执行
brew install llvm，安装完成后Clang-Tidy会包含在LLVM的工具集中。 - Windows系统：可以从LLVM官方下载安装包，安装时勾选Clang-Tidy组件，安装完成后将对应路径添加到系统环境变量中即可使用。
基础使用方式
安装完成后，就可以直接对单个C++文件进行静态分析，基础命令格式如下：
// 待检查的示例C++代码，保存为test.cpp
#include <vector>
#include <iostream>
void print_vector() {
std::vector<int> vec = {1, 2, 3};
// 这里存在潜在的越界风险，Clang-Tidy会检测出来
for (int i = 0; i <= vec.size(); i++) {
std::cout << vec[i] << std::endl;
}
}
int main() {
print_vector();
return 0;
}
在终端中进入文件所在目录，执行以下命令即可运行检查：
clang-tidy test.cpp -- -std=c++11
命令中--后面的参数是传递给Clang的编译选项，需要指定项目使用的C++标准，否则可能会出现解析错误。运行后工具会输出检查到的所有问题，包含问题位置、问题类型和修改建议。
常用检查规则配置
Clang-Tidy内置了大量检查规则，默认会启用一部分基础规则，也可以通过配置文件自定义需要启用的规则。常见的规则分类如下：
| 规则类型 | 作用说明 | 示例规则 |
|---|---|---|
| 错误检查类 | 发现代码中的潜在bug、未定义行为 | bugprone-* |
| 代码规范类 | 检查代码是否符合编码风格要求 | google-*、llvm-* |
| 性能优化类 | 发现代码中可以优化的性能点 | performance-* |
| 现代C++适配类 | 建议使用现代C++特性替代旧写法 | modernize-* |
如果需要启用特定规则，可以在命令中通过-checks=参数指定，多个规则用逗号分隔，例如：
// 启用bug检查和现代C++适配规则 clang-tidy test.cpp -checks=bugprone-*,modernize-* -- -std=c++11
项目集成与自定义配置
对于大型项目，每次手动输入命令和规则比较繁琐，可以通过项目根目录下的.clang-tidy配置文件来统一配置检查规则。配置文件采用YAML格式，示例内容如下：
Checks: > bugprone-*, modernize-*, performance-*, -bugprone-narrowing-conversions # 禁用不需要的规则，前面加负号 WarningsAsErrors: > bugprone-* # 将bug类问题视为错误，编译不通过 HeaderFilterRegex: '.*' # 检查所有头文件
配置完成后，在项目根目录执行clang-tidy命令，工具会自动读取配置文件中的规则进行检查。也可以将Clang-Tidy集成到CMake构建流程中，在CMakeLists.txt中添加如下配置：
# 启用Clang-Tidy检查
set(CMAKE_CXX_CLANG_TIDY
clang-tidy;
-checks=bugprone-*,modernize-*;
-header-filter=.*;
)
这样在每次编译项目时，都会自动运行Clang-Tidy进行代码检查，及时发现问题。
检查结果解读与修复
Clang-Tidy输出的检查结果会包含文件路径、行号、列号、问题严重级别、问题描述和修改建议。部分问题支持自动修复，只需要在命令中添加-fix参数，工具就会自动修改代码中的问题，例如：
// 自动修复检查到的问题 clang-tidy test.cpp -fix -checks=modernize-* -- -std=c++11
需要注意的是，自动修复可能会修改代码逻辑，建议在修复前先备份代码，或者结合版本控制工具确认修改内容是否符合预期。
C++Clang-Tidy静态分析代码质量检查代码规范检查修改时间：2026-06-09 12:51:34