VS2010 除錯提示「Cannot find or open the PDB file」完整解決方案

問題現象

在 Visual Studio 2010 中除錯呼叫 API 時，回傳控制碼為 NULL，GetLastError() 回傳 126 (ERROR_MOD_NOT_FOUND)。輸出視窗大量顯示：

'Loaded C:\Windows\System32\ntdll.dll', Cannot find or open the PDB file
'Loaded C:\Windows\System32\kernel32.dll', Cannot find or open the PDB file
...

根本原因

PDB (Program Database) 是偵錯符號檔。系統 DLL (ntdll.dll, kernel32.dll 等) 的 PDB 檔預設不在專案目錄，VS 找不到時會輸出此訊息。這只是警告，不代表程式錯誤。真正導致 LoadLibrary 失敗 (錯誤 126) 的原因通常是：

1. DLL 路徑錯誤或相依 DLL 缺失
2. 位元數不匹配 (x86 專案載入 x64 DLL 或反向)
3. DLL 內部 DllMain 失敗

解決「找不到 PDB」的三種方案

方案一：啟用 Microsoft Symbol Servers (推薦)

1. 選單 Tools → Options → Debugging → Symbols
2. 勾選 Microsoft Symbol Servers
3. 設定快取目錄 (如 C:\Symbols)
4. 重新除錯，VS 會自動下載對應版本的系統 DLL PDB

方案二：以「不偵錯模式」執行 (最快驗證)

• 按 Ctrl + F5 (Start Without Debugging)
• 或在 命令提示字元 直接執行 .exe

此模式不載入符號，不會顯示 PDB 警告，能快速確認程式邏輯是否正常。

方案三：忽略特定模組符號載入

除錯時 → Debug → Windows → Modules 右鍵模組 → Symbol Load Information → 取消勾選「Always load symbols」

針對錯誤 126 (LoadLibrary 失敗) 的真正排查步驟

1. 確認 DLL 路徑：使用絕對路徑或將 DLL 放在 exe 同目錄 / 系統目錄 / PATH 目錄。
2. 檢查位元數：專案屬性 → Platform Target (x86/x64) 必須與 DLL 一致。
3. 依賴分析：使用 Dependency Walker (depends.exe) 開啟 DLL，查看紅色缺失的相依項。
4. 啟用 Loader Snaps：登錄表 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\your.exe 新增 GlobalFlag = 0x00000040，重新除錯查看詳細載入日誌。

快速判斷表

核心觀念：「Cannot find PDB」≠ 程式錯誤。它只是說「沒有這個 DLL 的原始碼行號資訊」。專注解決 GetLastError() 回傳的真實錯誤碼，才是除錯正道。