必须加 -fsanitize=address，否则asan完全不生效；它触发编译插桩与运行时库链接，配合 -g -o1 -fno-omit-frame-pointer 才能实现完整内存错误及泄漏检测。
clang 编译时必须加 -fsanitize=address
不加这个 flag，其他任何选项都无效。ASan 是编译期插桩 + 运行时检测的组合，-fsanitize=address 会同时触发编译器生成影子内存检查逻辑、链接 ASan 运行时库（如 clang_rt.asan_dynamic-x86_64），缺一不可。
常见错误是只加了 -g 或 -fno-omit-frame-pointer 就以为启用了——这些只是辅助项，没它可能报错定位不清，但没 -fsanitize=address 就完全没检测能力。
-
-O1是推荐的最低优化级：-O0虽然也能用，但部分内存访问模式（比如某些内联展开）在未优化下可能绕过插桩；-O2及以上可能因过度优化导致报告错位或漏报 -
-fno-omit-frame-pointer必须配对使用：否则调用栈会截断，泄漏点只能看到malloc而看不到你自己的函数名和行号 -
-g不是可选的：没有调试信息，ASan 报告里连源文件路径都没有，只剩地址和符号，基本没法修
链接阶段不能漏掉 ASan 运行时库
Clang 在识别到 -fsanitize=address 后，通常会自动链接对应架构的动态运行时（如 clang_rt.asan_dynamic-x86_64.dll 或 .so）。但如果你显式用了 -nostdlib、-nodefaultlibs 或自定义链接脚本，就可能跳过这步，导致运行时报错：undefined symbol: __asan_init 或直接段错误。
手动补救方式（仅限必要场景）：
- Linux/macOS：加
-lclang_rt.asan-x86_64（静态）或确保LD_LIBRARY_PATH包含 Clang 的lib目录 - Windows（MSVC 工具链）：必须用
/fsanitize=address（不是-fsanitize=address），且需安装完整 C++ 工作负载，否则链接时会报LNK1356: cannot find library 'clang_rt.asan_dynamic-i386.lib' - 交叉编译时：
--target必须与 ASan 运行时库架构严格匹配，比如--target=aarch64-linux-gnu就得用 aarch64 版本的asan_rt
泄漏检测默认开启，但有隐性依赖
-fsanitize=address 编译出的程序，只要正常退出（非 kill -9、abort() 未处理等），就会在 exit() 前自动扫描堆内存并报告泄漏。但这个机制依赖两个条件：
- 主程序必须调用
exit()或从main()正常返回；用_Exit()、std::quick_exit()或直接系统调用sys_exit会跳过清理，泄漏不报 - 所有分配必须来自 ASan 拦截的标准接口（
malloc/new/calloc等）；用mmap(MAP_ANONYMOUS)、自定义内存池或VirtualAlloc分配的内存，ASan 完全看不见，也不会计入泄漏统计 - 多线程环境下，若主线程提前退出而子线程仍在 malloc，可能造成误报——ASan 只在主线程 exit 时快照，此时子线程的活跃分配会被当作泄漏
Windows 上用 MSVC 工具链要换参数写法
Clang for Windows 和 MSVC cl.exe 对 ASan 的启用方式不同，混用会失败：
- 用
clang-cl（兼容 MSVC 命令行）：参数仍是-fsanitize=address，但需确保 PATH 中 clang 的 bin 目录在 MSVCcl.exe之前 - 用原生
cl.exe（Visual Studio 自带）：必须用/fsanitize=address，且仅支持 x64/x86，不支持 ARM64；同时禁用/RTC、编辑并继续（Edit and Continue）、增量链接（/INCREMENTAL） - 环境变量生效位置不同：Linux/macOS 用
ASAN_OPTIONS=detect_leaks=0，Windows 下对应的是ASAN_OPTIONS=disable_coredump=1:detect_leaks=0，大小写和分隔符都不能错
clang -fsanitize=address -g -O1 -fno-omit-frame-pointer example.c -o example。其余都是为覆盖特定边界情况加的——比如你真在写 Windows 驱动或嵌入式 loader，才需要关心静态链接和运行时 DLL 的部署细节。
