Visual Studio 中使用 AddressSanitizer 指南

基于 Microsoft Visual Studio 2022，支持 MSVC 和 Clang 編譯器鏈，本文詳細說明如何在 VS 中配置和使用 AddressSanitizer，用于檢測內存誤用，如消息釋放后訪問、超界讀寫等類型錯誤。

---

一、ASan 是什么？

AddressSanitizer （ASan） 是一個輕量級的內存檢測器，用于在運行時檢測:

• 訪問已釋放的內存 (Use-after-free)
• 堆/棧/全局超界讀寫 (Buffer overflow)
• 未初始化內存訪問
• Double free / 內存泄漏

ASan 實際上是編譯器打表 + 擴展運行時加載組成，這需要對應的編譯器支持。

---

二、安裝 AddressSanitizer 支持

重點：VS2022 配置項

1. 打開 Visual Studio Installer

2. 點擊“修改”已安裝的 VS 版本

3. 搜索 AddressSanitizer，勾選 C++ AddressSanitize 組件

4. (選填) 勾選 Clang Toolchain：

   • “適用于 Windows 的 C++ Clang 編譯器”
   • “LLVM(clang-cl) 工具集”

如果未安裝該組件，MSVC 無法使用 /fsanitize=address 選項！

---

三、Visual Studio 中的兩種工具鏈

在 Visual Studio 中可以選擇使用：

工具鏈	描述
MSVC（默認）	微軟自研編譯器，性能好，兼容性強
Clang/LLVM	Clang 編譯器，支持更強的診斷能力和 ASan

若希望啟用 AddressSanitizer，推薦使用 Clang 工具鏈（clang-cl）。

---

四、MSVC 編譯器下啟用 ASan

1. 使用 MSVC (Visual Studio 默認)
2. 項目屬性中設置:

（注意配置 Debug / x64）

• C/C++ -> 調試信息格式 設置為 程序數據庫 (/Zi)

• C/C++ -> 全局選項 設置:

  • 啟用地址清理系統 ： 是 (/fsanitize=address)
  • 優化 ： 已禁用 (/Od)

• 鏈接器 -> 生成調試信息 ： /DEBUG

?備注：實際上現在已經支持 x64 和 Release 版本，所以調試信息、優化等默認即可。

示例代碼

#include <iostream>int main()
{int* p = new int(123);std::cout << *p << std::endl;   // 正常訪問內存delete p;                       // 釋放內存std::cout << *p << std::endl;   // 懸空指針訪問，應該觸發 ASan 報錯std::cin.get();                 // 等待輸入，保持控制臺窗口return 0;
}

運行后輸出：

運行時：

• 不要用 F5 (調試)
• 請使用 Ctrl + F5 (開始執行，不調試)

?注意：千萬不要使用調試（F5）。

---

五、MFC / 圖形界面程序中查看 AddressSanitizer 輸出

AddressSanitizer（ASan）默認將檢測信息通過控制臺（標準輸出）打印出來。但對于 MFC、Qt 等圖形界面程序，Visual Studio 默認構建為 “Windows 子系統”，是不顯示控制臺窗口的，導致你可能根本看不到報錯信息。

? 解決方式一：手動打開控制臺窗口

可以在程序入口初始化時調用以下代碼，手動打開一個控制臺窗口，接收 ASan 的輸出：

#include <windows.h>
#include <iostream>void EnableConsole()
{AllocConsole();FILE* pCout;freopen_s(&pCout, "CONOUT$", "w", stdout);freopen_s(&pCout, "CONOUT$", "w", stderr);freopen_s(&pCout, "CONIN$", "r", stdin);std::ios::sync_with_stdio();std::cout.clear();std::cerr.clear();std::cin.clear();
}

然后在 InitInstance()（MFC）或 main() 中調用：

EnableConsole();

? 解決方式二：在命令行中運行 GUI 程序

你也可以通過命令行（如 PowerShell、CMD）進入程序目錄，直接運行程序：

cd D:\WorkCode\MyApp\bin\x64\Debug
MyApp.exe

控制臺會輸出 AddressSanitizer 的詳細錯誤信息（含堆棧地址）。

---

六、Clang Toolchain 注意事項

VS 支持 Clang-cl 實現簡單 ASan 分析，但有些限制:

• 需要自己配置 ASAN_SYMBOLIZER_PATH
• Clang 進程運行時無法讀取原始 PDB 路徑
• 無法完整顯示 free 時的堆棧調用欄

現階段下，建議先使用 MSVC + ASan 進行調試

---

七、數據解碼 symbolizer 應用

如果看到:

WARNING: Failed to use and restart external symbolizer!
AddressSanitizer can not provide additional info.

說明未連接到 symbolizer，需要設置環境變量:

ASAN_SYMBOLIZER_PATH="C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\Llvm\x64\bin\llvm-symbolizer.exe"

注意是 exe 路徑，且 VS 需要重新打開以便環境變量生效

可選配置：

ASAN_OPTIONS=fast_unwind_on_malloc=0:verbosity=1

---

八、Clang vs MSVC：使用體驗差異

對比項	MSVC 工具鏈	Clang 工具鏈
是否支持 AddressSanitizer	? 部分支持（需其他手段）	? 原生支持
調用棧符號是否完整	?（需配合符號服務器）	?（配合 llvm-symbolizer）
是否支持釋放位置追蹤	?	?（前提是配置正確）
調試體驗	VS 原生調試器佳	調試信息略難查看

?注意：當前 Visual Studio + Clang-cl 工具鏈下的 ASan 功能仍有局限，例如釋放堆棧無法完整顯示（除非使用原生 clang++ 工具鏈和 CMake 工程）。

---

九、Clang 工具鏈支持現狀

雖然 ASan 支持 Clang，但在 Windows 上使用 LLVM (clang-cl) 工具集時，當前版本的 Visual Studio 中 并不能很好地兼容 symbolizer 輸出。

當前問題：

• 報錯時能捕捉越界或懸空指針問題，但棧信息無法正常符號化。
• ASAN_SYMBOLIZER_PATH 設置無效或無觸發。

原因：

MSVC 的 asan_runtime 模塊在內部鏈接時處理了符號信息傳遞，而 clang-cl 的 runtime 在 Windows 下并未完整實現符號解析。

建議：

• 如果追求準確堆棧，建議當前仍使用 MSVC 工具集進行分析。
• 可關注 LLVM for Windows 后續進展，或在 WSL/Linux 環境下使用 Clang + ASan。

---

十、官方參考文檔

• ASan for Windows (MSVC) 介紹 - Microsoft DevBlog
• ASan 支持 x64 和 Debug 配置 - VS 16.9 Preview
• MS Learn 文檔：ASan 使用指南

---

小結

目標	建議設置
快速檢測內存誤用	MSVC + AddressSanitizer
需要釋放類調用堆棧	原生 clang++ + CMake + symbolizer
文件細節 symbol	設置 ASAN_SYMBOLIZER_PATH