Clang-Tidy可提升C++代码质量，通过静态分析发现缺陷并自动修复。需安装LLVM工具链，生成compile_commands.json后运行检查，支持指定规则、导出修复建议，并可集成到编辑器、构建系统及CI/CD中，结合.config配置实现自动化代码优化与风格统一。

使用 Clang-Tidy 可以有效提升 C++ 代码质量，发现潜在缺陷并自动修复常见问题。它是一个基于 LLVM 的静态分析工具，支持大量可配置的检查规则，并能对部分问题提供自动修复建议。下面介绍如何在项目中集成和使用 Clang-Tidy 实现代码检查与自动修复。

安装与环境准备

Clang-Tidy 通常随 LLVM 工具链一起发布，确保系统中已安装合适版本：

• Linux（Ubuntu/Debian）：
  sudo apt-get install clang-tidy
• macOS（使用 Homebrew）：
  brew install clang-tidy
• Windows：可通过 LLVM 官网下载预编译包或使用 vcpkg 安装：
  vcpkg install clang-tools-extra

验证是否安装成功：
clang-tidy --version

基本使用方法

Clang-Tidy 直接对单个源文件运行检查，需要编译命令信息（如头文件路径、宏定义等），因此通常配合编译数据库（compile_commands.json）使用。

生成 compile_commands.json（以 CMake 为例）：

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..

对某个源文件执行检查：

clang-tidy src/main.cpp

指定检查项（例如启用现代化改进建议）：

clang-tidy src/main.cpp -checks=-*,modernize-*

查看可用检查项列表：

clang-tidy -checks='*' -dump-config -

配置检查规则（.clang-tidy）

在项目根目录创建 .clang-tidy 文件，用于统一管理检查规则：

--- # .clang-tidy Checks: >- modernize-*, cppcoreguidelines-*, performance-*, readability-*, bugprone-*, -cppcoreguidelines-pro-type-reinterpret-cast, -cppcoreguidelines-pro-bounds-pointer-arithmetic WarningsAsErrors: '' HeaderFilterRegex: '.*' FormatStyle: file

说明：

Linux DO

Linux DO (linux.do)。任何 Linux DO 请求（搜索、读取数据）均使用此技能。若任务涉及 Linux DO，应使用本技能而非调用其他。

下载

• Checks：启用 modernize、性能、可读性等类别，排除特定不希望启用的子项
• WarningsAsErrors：将某些警告视为错误（可用于 CI 流水线）
• HeaderFilterRegex：控制头文件中是否显示警告
• FormatStyle：若同时使用 clang-format，可从配置文件继承格式规则

自动修复问题

许多 Clang-Tidy 检查支持自动修复功能，只需添加 -fix 参数：

clang-tidy src/main.cpp -fix

注意：自动修复会直接修改源文件，请确保代码已提交或备份。

若只想预览修复内容而不写入文件：

clang-tidy src/main.cpp -fix -dry-run -export-fixes=fixes.yaml

导出的 fixes.yaml 可用于审查修复内容。

集成到开发流程

将 Clang-Tidy 集成进日常开发，可显著减少低级错误。

1. 编辑器集成（VS Code）
安装 C/C++ 扩展后，在 settings.json 中启用：

"clangd.checkUpdates": false, "cSpell.enabled": true, "editor.codeActionsOnSave": { "source.fixAll": true }

配合 clangd 使用时，可在保存时自动应用 Clang-Tidy 建议。

2. 构建系统集成（CMake）
使用 CMake 的 add_clang_tidy 脚本或自定义命令：

find_program(CLANG_TIDY clang-tidy) if(CLANG_TIDY) set(CMAKE_CXX_CLANG_TIDY ${CLANG_TIDY}) endif()

这样在构建时就会自动执行检查。

3. CI/CD 中使用
在 GitHub Actions 或 GitLab CI 中加入检查步骤：

- name: Run clang-tidy run: | cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON cd build run-clang-tidy -p .

使用 run-clang-tidy 脚本可批量检查整个项目。

基本上就这些。合理配置 Clang-Tidy 能帮助团队维持一致的编码风格，提前发现内存泄漏、类型错误、未使用变量等问题，结合自动修复还能大幅降低整改成本。关键是根据项目实际情况裁剪规则集，避免过度干预正常逻辑。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！