15、CTest内存检测：CTest与Valgrind集成、MEMCHECK命令、检测内存泄漏
内存泄漏，说白了就是程序里那些“只借不还”的内存块。C++里你new了没delete，或者智能指针循环引用了，内存就悄悄溜走了。我早年在一个嵌入式项目里吃过这个亏——程序跑了三天，内存占用从30%飙到95%，最后系统直接挂了。从那以后，内存检测就成了我CI流程里的标配。
CMake的CTest提供了MEMCHECK模式，专门用来做内存检测。它本身不检测内存，而是把脏活累活交给Valgrind这类工具。你只需要配好，剩下的CTest帮你搞定。
15.1 Valgrind是什么？为什么选它？
Valgrind是一个开源的内存调试和分析工具集。它的核心是Memcheck，专门抓内存泄漏、越界访问、使用未初始化内存等问题。
我个人的习惯是：所有涉及动态内存分配的C++项目，上线前必须跑一遍Valgrind。你想想看，一个内存泄漏在开发环境可能不痛不痒，但到了生产环境，跑上几天几周，那就是灾难。
Valgrind能检测的问题：
- 内存泄漏（Memory leak）
- 越界读写（Invalid read/write）
- 使用未初始化内存
- 重复释放（Double free）
- 不匹配的malloc/delete或new/free
15.2 CTest与Valgrind集成：三步走
集成过程其实不复杂。我拆成三步来讲，你跟着做就行。
第一步：安装Valgrind
Linux上直接装：
sudo apt-get install valgrind # Ubuntu/Debian
sudo yum install valgrind # CentOS/RHELmacOS上也可以用Homebrew装，但说实话，Valgrind在macOS上支持不太好。我建议你在Linux或Docker里跑。
第二步：配置CMake开启内存检测
在CMakeLists.txt里，你需要告诉CTest怎么调用Valgrind。有两种方式：
方式一：命令行指定（推荐用于CI）
ctest -D ExperimentalMemCheck \
-D CMAKE_MEMORYCHECK_COMMAND=/usr/bin/valgrind \
-D CMAKE_MEMORYCHECK_COMMAND_OPTIONS="--tool=memcheck --leak-check=full --error-exitcode=1"方式二：在CMakeLists.txt里预设（推荐用于本地开发）
include(CTest)
if(CMAKE_SYSTEM_NAME MATCHES "Linux")
find_program(MEMORYCHECK_COMMAND valgrind)
if(MEMORYCHECK_COMMAND)
set(MEMORYCHECK_COMMAND_OPTIONS
"--tool=memcheck --leak-check=full --error-exitcode=1")
message(STATUS "Valgrind found: ${MEMORYCHECK_COMMAND}")
endif()
endif()这里有个细节：--error-exitcode=1 这个参数很关键。它让Valgrind在检测到问题时返回非零退出码，CTest才能知道测试失败了。
第三步：运行MEMCHECK
配置好之后，运行起来就一行命令：
ctest -T memcheck或者更常用的：
ctest -D ExperimentalMemCheckCTest会逐个运行你的测试用例，每个测试都在Valgrind的监控下执行。结果会生成在 Testing/ 目录下。
15.3 实战：检测一个内存泄漏
光说不练假把式。我们来写一个有内存泄漏的测试代码，看看CTest怎么抓出来。
示例代码：leaky_test.cpp
#include <cstdlib>
#include <cassert>
void leak_memory() {
int* p = new int(42);
// 故意不delete，制造内存泄漏
}
int main() {
leak_memory();
// 这里应该能检测到泄漏
return 0;
}CMakeLists.txt
cmake_minimum_required(VERSION 3.16)
project(MemCheckDemo)
enable_testing()
add_test(NAME leak_test COMMAND leak_test)
add_executable(leak_test leak_test.cpp)运行并查看结果：
mkdir build && cd build
cmake ..
ctest -T memcheck输出会类似这样：
1/1 MemCheck #1: leak_test ....................*** Failed
Memory check found 1 error(s).
Details: /path/to/leak_test.cpp:5: (Leak) 4 bytes in 1 blocks
definitely lost: 4 bytes in 1 blocks看到了吗？CTest明确告诉你：leak_test.cpp第5行，泄漏了4个字节。这就是Valgrind的功劳，CTest只是把结果整理给你看。
我的小技巧： 在CI脚本里，我会把 ctest -T memcheck 的输出重定向到一个日志文件，然后解析这个文件，如果发现"definitely lost"或者"ERROR SUMMARY: 1"之类的关键词，就让CI任务失败。这样就能自动拦截内存泄漏。
15.4 MEMCHECK命令的进阶用法
CTest的MEMCHECK模式其实支持多种内存检测工具，不只是Valgrind。你可以通过设置 CMAKE_MEMORYCHECK_TYPE 来切换：
| 工具类型 | CMAKE_MEMORYCHECK_TYPE 值 | 说明 |
|---|---|---|
| Valgrind | Valgrind | 默认，功能最全 |
| AddressSanitizer | AddressSanitizer | 编译时插桩，速度更快 |
| Dr. Memory | DrMemory | Windows上常用 |
| Purify | Purify | 商业工具，老项目可能用到 |
我个人更推荐Valgrind，因为它不需要重新编译代码，直接跑二进制就行。但如果你追求速度，AddressSanitizer是个好选择——它编译时插桩，运行时开销小很多。
15.5 避坑指南：我踩过的几个坑
集成Valgrind和CTest的过程中，我遇到过不少问题。挑几个典型的说说：
坑一：Valgrind找不到
我曾经在CI环境里忘了装Valgrind，结果CTest静默跳过所有内存检测，测试全绿通过。后来才发现根本没跑。解决方案：在CMake里加一个检查，如果Valgrind没找到就报错：
if(NOT MEMORYCHECK_COMMAND)
message(FATAL_ERROR "Valgrind not found! Memory checks disabled.")
endif()坑二：测试超时
Valgrind会让程序运行慢10-20倍。我有个测试本来跑1秒，在Valgrind下跑了20秒，直接超时了。解决方案：给MEMCHECK测试单独设置更长的超时时间：
set_tests_properties(my_test PROPERTIES
TIMEOUT 120
COST 10.0
)坑三：误报
有些第三方库（比如OpenSSL）本身就有一些“无害”的内存泄漏，Valgrind会报出来。我建议用 --suppressions 参数来屏蔽这些已知问题：
set(MEMORYCHECK_COMMAND_OPTIONS
"--tool=memcheck --leak-check=full --suppressions=${CMAKE_SOURCE_DIR}/valgrind.supp")15.6 知识体系：CTest内存检测全景图
下面这张图帮你理清CTest内存检测的整体流程：
流程其实很清晰：CTest拿到你的测试用例，调用Valgrind（或其他工具）去跑，然后收集结果。如果Valgrind报错了，CTest就把这个测试标记为失败。
15.7 总结一下
CTest与Valgrind的集成，说白了就是给测试套上了一层“内存监控”。你不需要改代码，只需要配好CMake，然后跑 ctest -T memcheck 就行。
我个人的建议是：把内存检测加到CI流程里，每次提交都跑。虽然会慢一些，但比起线上出问题再排查，这点时间成本完全值得。你想想看，一个内存泄漏在开发阶段发现，改起来可能就几分钟；到了生产环境，你可能要花几天去定位。
嗯，关于CTest内存检测就聊到这儿。记住：内存泄漏不是Bug，是定时炸弹。用CTest+Valgrind，就是给你的代码买了一份“内存保险”。
公众号:蓝海资料掘金营，微信deep3321