AddressSanitizer能检测堆栈全局缓冲区溢出、use-after-free、double free等内存错误，通过编译器插桩在运行时快速定位问题，使用-g -O1 -fsanitize=address编译即可启用，配合CMake可在Debug模式集成，是高效实用的C++内存调试工具。
AddressSanitizer（ASan）是C++中一个高效的内存错误检测工具，主要用于在程序运行时发现常见的内存越界、使用已释放内存、栈/堆缓冲区溢出等问题。它由编译器插桩实现，集成在GCC和Clang中，能快速定位内存错误位置，相比Valgrind更轻量、运行更快。
AddressSanitizer能检测哪些问题
ASan主要能捕获以下几类内存错误：
- 堆缓冲区溢出（Heap buffer overflow）
- 栈缓冲区溢出（Stack buffer overflow）
- 全局变量缓冲区溢出（Global buffer overflow）
- 使用已释放的内存（Use-after-free）
- 返回栈上变量的引用（Use-after-return）
- 重复释放内存（Double free）
- 内存泄漏（部分支持，需启用LeakSanitizer）
一旦发生上述问题，ASan会立即打印出错信息，包括错误类型、发生位置的源码行号、调用栈等，极大方便调试。
如何使用AddressSanitizer
使用ASan非常简单，只需在编译和链接时加入特定标志即可。
立即学习“C++免费学习笔记（深入）”；
1. 编译和链接选项使用Clang或GCC时，添加以下编译选项：
-fsanitize=address -fno-omit-frame-pointer
推荐同时加上调试信息以获得更清晰的报错：
-g -O1
完整示例：
clang++ -g -O1 -fsanitize=address -fno-omit-frame-pointer example.cpp -o example
或使用GCC：
g++ -g -O1 -fsanitize=address -fno-omit-frame-pointer example.cpp -o example2. 运行程序
直接运行生成的可执行文件：
./example
如果存在内存错误，ASan会输出详细错误报告，例如：
=================================================================
==12345==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x...
READ of size 4 at 0x... thread T0
#0 0x... in main example.cpp:5
...
报告会指出哪一行代码访问了非法地址，以及内存布局情况。
常见使用注意事项
- 开启ASan后程序运行会变慢约2倍，内存占用增加，仅用于调试，不要用于生产发布。
- 避免与其他检测工具（如Valgrind、tcmalloc）混用，可能冲突。
- 某些系统库或第三方库若未用ASan编译，可能导致误报，可通过ASan选项屏蔽（如ASAN_OPTIONS=suppressions=supp.txt）。
- Windows下Clang也支持ASan，但配置较复杂；Linux和macOS支持较好。
结合CMake使用ASan
在CMakeLists.txt中可以这样启用ASan：
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O1 -fsanitize=address -fno-omit-frame-pointer")
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -g -O1 -fsanitize=address -fno-omit-frame-pointer")
或者更安全地只在Debug模式启用：
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
target_compile_options(target_name PRIVATE -fsanitize=address -fno-omit-frame-pointer)
target_link_options(target_name PRIVATE -fsanitize=address)
endif()
基本上就这些。只要在编译时加上对应标志，ASan就能帮你自动发现多数棘手的内存错误，是C++开发中非常实用的调试助手。不复杂但容易忽略。
