Clang scan-build搭配CMake/make无法检测代码问题的求助

阿华AIGC实验室

2026-5-13

解决scan-build配合CMake/make无法检测到代码问题的问题

我来帮你排查这个问题——其实核心原因是CMake的缓存机制和scan-build的工作方式不匹配，加上你的CMakeLists.txt里还有路径错误，导致scan-build没真正接管编译流程。

问题根源

路径错误：你的CMakeLists.txt里的编译器路径少了开头的/，比如usr/bin/clang应该是/usr/bin/clang，这会导致CMake找不到指定的clang，转而使用系统默认的gcc，自然没法触发Clang的静态分析。
CMake缓存干扰：当你先执行cmake .时，CMake已经把编译器信息写入CMakeCache.txt和CMakeFiles目录里了，之后再运行scan-build make，scan-build无法替换已经缓存的编译器配置，实际还是用之前配置的编译器在编译，没有启用静态分析。
scan-build的正确用法：scan-build需要接管整个构建配置过程，而不是只接管make阶段。

解决方案

步骤1：清理旧的CMake缓存

先删除之前生成的CMake缓存文件和目录，确保从头开始：

rm -rf CMakeCache.txt CMakeFiles scan-build-test

步骤2：修改CMakeLists.txt（可选但推荐）

去掉硬编码的编译器配置，让scan-build自动设置CC和CXX环境变量，这样更灵活：

cmake_minimum_required(VERSION 3.10)
project(scan-build-test)
add_executable(${PROJECT_NAME} main.cpp)

如果一定要硬编码编译器，记得修正路径：

cmake_minimum_required(VERSION 3.10)
set(CMAKE_C_COMPILER "/usr/bin/clang")
set(CMAKE_CXX_COMPILER "/usr/bin/clang++")
set(CMAKE_AR "/usr/bin/llvm-ar")
set(CMAKE_LINKER "/usr/bin/llvm-ld")
set(CMAKE_NM "/usr/bin/llvm-nm")
set(CMAKE_OBJDUMP "/usr/bin/llvm-objdump")
set(CMAKE_RANLIB "/usr/bin/llvm-ranlib")
project(scan-build-test)
add_executable(${PROJECT_NAME} main.cpp)

步骤3：用scan-build接管整个CMake构建流程

直接用scan-build调用cmake和make，或者一步到位：

# 方式1：分开执行（先配置再构建）
scan-build cmake .
scan-build make

# 方式2：一步完成
scan-build make -f CMakeLists.txt

如果系统有多个Clang版本，可以指定具体版本：

scan-build --use-c++=/usr/bin/clang++ cmake .
scan-build --use-c++=/usr/bin/clang++ make

验证结果

执行完上面的步骤后，你应该能看到类似这样的输出：

scan-build: Using '/usr/bin/clang-8' for static analysis
[ 50%] Building CXX object CMakeFiles/scan-build-test.dir/main.cpp.o
main.cpp:6:2: warning: 1st function call argument is an uninitialized value
std::cout << a << std::endl;
^~~~~~~~~~~~~~
1 warning generated.
[100%] Linking CXX executable scan-build-test
[100%] Built target scan-build-test
scan-build: 1 bug found.
scan-build: Run 'scan-view /tmp/scan-build-xxxxxx-xxxxxx-1' to examine bug reports.