AddressSanitizer（ASan）是C++中用于检测内存错误的高效工具，集成于GCC和Clang中，通过编译时插入检查代码来捕获堆、栈、全局变量的缓冲区溢出、use-after-free、double-free等问题。启用需添加-fsanitize=address -fno-omit-frame-pointer -g -O1编译选项，配合调试信息和符号化环境变量可输出清晰的错误位置。适用于开发调试阶段，运行时内存开销较大，不推荐用于生产环境。

AddressSanitizer（ASan）是C++中一个高效的内存错误检测工具，集成在GCC和Clang编译器中，能快速发现常见的内存问题，比如缓冲区溢出、使用已释放内存、栈/堆越界访问等。它通过在编译时插入检查代码来实现检测，运行时开销较小，适合开发和调试阶段使用。

启用AddressSanitizer

要在项目中使用ASan，只需在编译和链接时添加 -fsanitize=address 选项。

示例（使用g++或clang++）：

g++ -fsanitize=address -fno-omit-frame-pointer -g -O1 your_program.cpp -o your_program

关键编译选项说明：

• -fsanitize=address：启用AddressSanitizer
• -fno-omit-frame-pointer：保留帧指针，有助于生成更清晰的调用栈
• -g：加入调试信息，让报错更具体（显示文件名和行号）
• -O1 或更高：建议至少使用 -O1，某些检查在 -O0 下可能不工作

常见能检测的错误类型

ASan 能自动捕获以下典型内存错误：

立即学习“C++免费学习笔记（深入）”；

• 堆缓冲区溢出：new/delete 分配的内存读写越界
• 栈缓冲区溢出：局部数组越界访问
• 全局缓冲区溢出：全局数组越界
• 使用释放后的堆内存（use-after-free）
• 双重释放（double-free）或无效释放
• 返回栈内存地址（returning address of stack variable）

示例：检测堆溢出

 #include <iostream> int main() {     int *arr = new int[5];     arr[5] = 10;  // 越界写入     delete[] arr;     return 0; } 

编译并运行后，ASan会输出类似如下错误信息：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

 ==12345==ERROR: AddressSanitizer: heap-buffer-overflow on address ... WRITE of size 4 at ... offset 20 in container of size 20 allocated by thread T0     #0 in main ... at example.cpp:4 

清楚指出哪一行发生了越界写入，分配位置也一并显示。

配合调试工具使用

ASan 输出的堆栈信息默认可能不完整。可通过环境变量提升可读性：

• 设置符号化路径：确保二进制包含调试信息（-g）
• 使用 ASAN_SYMBOLIZER_PATH 指向 llvm-symbolizer（如果使用Clang）
• 开启人类可读堆栈：
  export ASAN_OPTIONS=symbolize=1
  export ASAN_SYMBOLIZER_PATH=/usr/bin/llvm-symbolizer （路径视系统而定）

这样报错信息会直接显示文件名和行号，而不是内存地址。

注意事项与限制

虽然ASan非常实用，但也有几点需要注意：

• 主要适用于linux、macOS和部分windows（MSVC支持有限，推荐用Clang-CL）
• 运行时内存开销较大（约2倍），不适合生产环境
• 不能检测所有内存问题，例如未初始化内存读取需用MemSan（仅Clang支持）
• 避免与其他 sanitizer 同时启用（如UBSan、TSan），除非明确支持组合使用

基本上就这些。只要在编译时加上对应标志，ASan就能帮你抓到大多数棘手的内存bug，省去大量调试时间。日常开发中建议在单元测试中开启ASan进行回归检测。不复杂但容易忽略。