如何在PlatformIo native环境启用AddressSanitizer检测内存问题

针对你的需求——在PlatformIO的native测试环境中集成AddressSanitizer（ASAN），让内存泄漏/错误直接导致gtest测试失败，以下是具体实现步骤：

1. 修改platform.ini配置 #

给native环境添加编译、链接参数和ASAN运行时配置，确保ASAN被启用且能触发测试失败：

[env]
test_framework = googletest

[env:native]
platform = native
build_src_filter = ... ; 保留你现有的Arduino代码过滤规则
build_flags = 
    -fsanitize=address       ; 启用地址 sanitizer
    -fno-omit-frame-pointer  ; 生成更准确的栈回溯信息，方便定位问题
    -O1                      ; 低优化级别，避免优化导致ASAN检测不准确，同时兼顾速度
test_env = 
    ASAN_OPTIONS=detect_leaks=1:exitcode=1  ; 启用泄漏检测，且泄漏时进程返回非零码（触发测试失败）

参数说明： #

• -fsanitize=address：核心开关，启用ASAN的内存错误（越界、使用释放内存等）和泄漏检测。
• -fno-omit-frame-pointer：解决ASAN在部分优化场景下栈回溯模糊的问题，让错误定位更精准。
• -O1：ASAN推荐使用低优化级别，既不会像-O0那样拖慢太多速度，又能保证检测的准确性。
• ASAN_OPTIONS=detect_leaks=1:exitcode=1：默认ASAN检测到泄漏只会打印日志但不影响进程退出码，这个配置让它在发现泄漏时返回1，gtest会将整个测试套件标记为失败。

2. 验证配置 #

写一个故意泄漏内存的测试用例来验证：

#include <gtest/gtest.h>
#include <cstdlib>

TEST(MemoryLeakTest, DeliberateLeak) {
    // 分配内存后不释放，制造泄漏
    int* leaky_ptr = new int[10];
}

运行测试命令：

pio test -e native

你会看到ASAN输出详细的泄漏报告，同时gtest会显示测试失败，符合预期。

3. 注意事项 #

• 系统兼容性：ASAN支持Linux、macOS和Windows（需用MinGW-w64或MSVC），确保你的开发环境在支持列表内。
• 性能影响：启用ASAN后测试会比普通测试慢一些，但远快于Valgrind，满足你频繁运行测试的需求。
• 误排查：如果第三方库或静态分配内存出现误报，可通过ASAN的抑制文件（suppressions.txt）过滤，具体可在ASAN_OPTIONS中添加suppressions=suppressions.txt。
• Arduino代码隔离：确保build_src_filter完全排除了Arduino专属代码（如依赖硬件的API），避免native环境编译失败。

内容的提问来源于stack exchange，提问作者Spina