在 Visual Studio 調試程式中指定符號 （.pdb） 和來源檔案 （C#， C++， Visual Basic， F#）

程序資料庫（.pdb）檔案，也稱為符號檔，將專案原始程式碼中的標識符和語句對應到已編譯應用程式中的對應標識符和指令。 這些對應檔案會將調試程序連結至您的原始程式碼，以啟用偵錯。

當您使用標準偵錯組建組態從Visual Studio IDE 建置專案時，編譯程式會建立適當的符號檔。 本文說明如何在 IDE 中管理符號檔，例如：

• 設定符號檔的位置
• 偵錯時 載入符號
• 符號的編譯器選項

如需符號檔的詳細說明，請參閱 瞭解符號檔和 Visual Studio 符號設定。

符號檔的運作方式

.pdb 檔案會保存偵錯和專案狀態資訊，以允許對應用程式的偵錯組態進行累加連結。 Visual Studio 調試程式會使用 .pdb 檔案，在偵錯時判斷兩個主要資訊片段：

• 要在 Visual Studio IDE 中顯示的原始檔案名稱和行號
• 在應用程式中停止中斷點的位置

符號檔也會顯示來源檔案的位置，並選擇性地顯示要從中擷取來源檔案的伺服器。

調試程式只會載入 .pdb 檔案，與建置應用程式時所建立的 .pdb 檔案完全相符（也就是原始 .pdb 檔案或複本）。 這種確切的重複是必要的，因為即使程式碼本身未變更，應用程式的版面配置也可能會變更。 如需詳細資訊，請參閱 為什麼Visual Studio需要調試程式符號檔才能完全符合其所建置的二進位檔？

提示

若要在專案原始程式碼之外偵錯程式代碼，例如 Windows 程式代碼或專案呼叫的第三方程式代碼，您必須指定外部程式碼 .pdb 檔案的位置（以及選擇性地指定原始程式檔），這必須完全符合您應用程式中的組建。

偵錯工具搜尋符號的位置

當您在 Visual Studio IDE 中偵錯專案時，調試程式會自動載入預設可找到的符號檔。

注意

在遠端裝置上偵錯 Managed 程式代碼時，必須將所有符號檔放在本機電腦上，或者放置在偵錯工具選項中指定的位置 。

偵錯工具會依指定的順序在下列位置搜尋符號檔：

1. 項目資料夾。

2. DLL 或可執行檔 （.exe） 檔案內指定的位置。

   根據預設，如果您在計算機上建置 DLL 或 .exe 檔案，鏈接器會將相關聯 .pdb 檔案的完整路徑和檔名放在 DLL 或 .exe 檔案中。 調試程式會檢查符號檔是否存在於該位置。

3. 與 DLL 或 .exe 檔案相同的資料夾。

4. 符號檔之調試程序選項中指定的任何位置。 若要新增與啟用符號位置，請參閱 設定符號位置和載入選項。

   • 任何本機符號快取資料夾。

   • 指定的網絡、互聯網或本機符號伺服器及位置，例如所選的 Microsoft 符號伺服器。 Visual Studio 可以從實作 symsrv 通訊協定的符號伺服器下載偵錯符號檔。 Visual Studio Team Foundation Server 和適用於 Windows 的 偵錯工具是兩個可以使用符號伺服器的工具。

     您可以使用的符號伺服器包括：

     公用Microsoft符號伺服器：若要對系統 DLL 或第三方連結庫呼叫期間發生的當機進行偵錯，您通常需要系統 .pdb 檔案。 系統 .pdb 檔案包含 Windows DLL、.exe 檔案和設備驅動器的符號。 您可以從公用Microsoft符號伺服器取得 Windows 作業系統、MDAC、IIS、ISA 和 .NET 的符號。

     內部網路上或本機計算機上的符號伺服器：您的小組或公司可以為自己的產品建立符號伺服器，以及做為來自外部來源之符號的快取。 您可能在自己的電腦上有符號伺服器。

     第三方符號伺服器：Windows 應用程式和連結庫的第三方提供者可以提供因特網上符號伺服器的存取權。

警告

如果您使用公用Microsoft符號伺服器以外的符號伺服器，請確定符號伺服器及其路徑值得信任。 因為符號檔可以包含任意可執行的程式代碼，因此您可以公開給安全性威脅。

設定符號檔的位置和載入選項

調試程式預設會檢查各種位置是否有符號。 如需詳細資訊，請參閱偵錯工具的符號搜尋位置。

從 工具 （或 偵錯） >選項 功能表中，您可以存取 偵錯符號>選項：

• 指定並選取符號檔的搜尋路徑。
• 指定用於 Microsoft、Windows 或第三方元件的符號伺服器。
• 指定您執行或不想讓調試程式自動載入符號的模組。
• 在主動偵錯時變更這些設定。 請參閱偵錯時載入符號。

若要指定符號位置和載入選項：

1. 開啟 [工具] （或 [偵錯]）>選項 窗格，然後展開 [所有設定]>偵錯>一般>符號>搜尋位置 區段。

2. 在右窗格中，選取每個所需伺服器的複選框： Microsoft符號伺服器、 NuGet.org 符號伺服器等等。

3. 在 [符號檔 （.pdb） 位置] 群組方塊的工具列中選取 [+ 新增]，以新增符號伺服器位置。

   在文字欄位中輸入符號伺服器或符號位置的 URL （http）、網路共用或本機路徑。 語句補全工具可協助您尋找正確的格式。

   

   注意

   只會搜尋指定的資料夾。 您必須為想要搜尋的每個子資料夾新增項目。

   選取 [已啟用] 核取方塊，然後選取 [儲存]。

4. 選取 [ 新增 Azure DevOps 符號伺服器位置 ] 連結，以新增 Azure DevOps 符號伺服器位置。

   在 [連線到 Azure DevOps 符號伺服器] 對話方塊中，選取可用的符號伺服器，然後選取 [連線]。

   

   如需詳細資訊，請參閱 新增 Azure Artifacts 符號伺服器。

   • 若要變更符號位置的載入順序，請使用 Ctrl + 向上 和 Ctrl + 向下，或選取 「向上移動」 和 「向下移動」。
   • 若要編輯 URL 或路徑，請按兩下項目，或選取項目並選擇 編輯。
   • 若要移除項目，請反白顯示該項目，然後選取 [移除]。

5. （選用）透過指定複製符號的本機資料夾路徑來改善符號載入效能。

   針對 緩存此目錄中的符號 選項，輸入一個符號伺服器可以將符號複製到的本機資料夾路徑。

   注意

   • 請勿將本機符號快取放在受保護的資料夾中，例如 C：\Windows 或子資料夾。 請改用讀寫資料夾。

   • 如果已設定 _NT_SYMBOL_PATH 環境變數，則該值會置換 此目錄中的快取符號 值。

6. 指定偵錯工具啟動時要從符號檔 （.pdb） 位置載入的模組。

   1. 變更為 所有設定>偵錯>一般>符號>搜尋和載入 區段。

   2. 使用下拉式清單來設定 自動符號搜尋 選項的值：

      • 自動選擇要搜尋的模組符號 （建議）： 允許 Visual Studio 決定要搜尋和載入的符號。 根據預設，Visual Studio 會自動載入您開啟的解決方案所建置的符號，並載入執行一般偵錯作業所需的任何其他符號。 此選項可減少 Visual Studio 必須搜尋和載入的檔案數目，進而改善偵錯工具效能。 您可以建立 包含模組的清單，以強制載入其他符號。

        

      • 搜尋所有模組符號（除非已排除）：強制 Visual Studio 載入您偵錯程式中所有的符號。 不建議使用此選項，因為它可能會降低您的偵錯體驗。 您可以建立排除 的模組清單，強制 Visual Studio 忽略特定符號。

        

指定模組篩選

「 自動選擇...」 和 「搜尋所有... 」選項都可讓您控制在偵錯期間搜尋哪些符號。

對於 自動選擇要搜尋的模組符號選項 ，請建立 包含的模組 清單來指定搜尋清單。

1. 選取清單工具列中的 + 新增 。

2. 在 [ 新增專案 ] 對話方塊中，輸入 [模組名稱]，選取 [ 已啟用 ] 複選框，然後選取 [ 儲存]。

3. 視需要將更多項目新增至清單。

模組篩選支持簡單的通配符比對。 星號 * 符合任何字元群組。 例如， *myproduct* 會比對 myproduct.utilities.dll 和 entrypoint.myproduct.exe等檔案。

您可以設定其他選項來自訂您的體驗：

• 一律載入位於模組旁邊的符號：Visual Studio 會載入儲存在檔案系統中的 .pdb 檔案及其對應的 .dll 或 .exe 檔案。 此方法可能會很有幫助，例如嘗試偵錯已部署的 Web 應用程式時。

• 視需要自動載入其他符號：Visual Studio 會搜尋符號以執行常見的偵錯動作，例如逐步執行，即使您要逐步執行的模組不在專案或模組篩選中也一樣。 搜尋的決定方式可能會受到「 僅限我的程式碼」 設定的影響。

對於 搜尋所有模組符號，除非排除 選項，請建立 排除的模組 清單來指定搜尋清單。

1. 選取清單工具列中的 + 新增 。

2. 在 [ 新增專案 ] 對話方塊中，輸入 [模組名稱]，選取 [ 已啟用 ] 複選框，然後選取 [ 儲存]。

3. 視需要將更多項目新增至清單。

偵錯的其他符號選項

您可以從 [工具] （或 [偵錯） >] 功能表中選取更多偵錯符號選項。

下列設定可在 [ 所有設定>偵錯>一般 ] 區段中使用。

• 載入 dll 匯出 （僅限原生）：載入 C/C++ 的 DLL 匯出資料表。 如需詳細資訊，請參閱 DLL 匯出數據表。 讀取 DLL 匯出資訊牽涉到一些額外負荷，因此預設會關閉載入匯出數據表。 您也可以在 C/C++組建命令行中使用 dumpbin /exports。

• 啟用位址層級偵錯 ，並在 來源無法使用時顯示反組譯：找不到來源或符號檔案時，一律顯示反組譯。

• 啟用來源伺服器支援：在本機電腦上沒有原始程式碼，或 .pdb 檔案與原始程式碼不相符時，使用來源伺服器來協助偵錯應用程式。 來源伺服器會接收檔案請求，並從原始碼控制中返回實際檔案。 來源伺服器會使用名為 srcsrv.dll 的 DLL 執行，以讀取應用程式的 .pdb 檔案。 .pdb 檔案包含原始程式碼儲存庫的指標，以及用來從儲存庫擷取原始程式碼的命令。

  您可以藉由在名為 srcsrv.ini的檔案中列出允許的命令，以限制 srcsrv.dll 可以從應用程式的 .pdb 檔案中執行的命令。 將 srcsrv.ini 檔案放在與 srcsrv.dll 相同的資料夾中，並 devenv.exe。

  重要

  任意命令可以內嵌在應用程式的 .pdb 檔案中，因此請務必只將您想要執行的命令放入 srcsrv.ini 檔案中。 任何嘗試執行不在 srcsvr.ini 檔案中的命令都會觸發確認對話方塊。 如需詳細資訊，請參閱 安全性警告：調試程式必須執行不受信任的命令。

  在命令參數上不會執行驗證，因此請小心信任的命令。 例如，如果您在 srcsrv.ini中列出 cmd.exe，惡意使用者可能會在 cmd.exe 上指定參數，這可能會使其變得危險。

  選擇任何所需的支援偏好設定。 請記住，允許來源伺服器進行部分信任的組件（僅限受控）和一律執行不受信任的來源伺服器命令且不提示選項可能會增加安全性風險。

編譯程式符號選項

當您使用標準 偵錯 建置組態從Visual Studio IDE 建置專案時，C++和 Managed 編譯程式會為您的程式代碼建立適當的符號檔。 您也可以在程式代碼中設定編譯程序選項。

若要在 Visual Studio 中設定組建組態的編譯程式選項，請參閱 設定偵錯和發行組態。

.NET 選項

使用 /debug 建置，以建立 .pdb 檔案。 您可以使用 /debug：full 或 /debug：pdbonly建置應用程式。 使用 /debug:full 建置， 會產生可偵錯的程式代碼。 使用 /debug:pdbonly 建置會產生 .pdb 檔案，但不會產生 DebuggableAttribute，這告知 JIT 編譯器偵錯資訊可用。 如果您想要為不想偵錯的發行組建產生 .pdb 檔案，請使用 /debug：pdbonly。 如需詳細資訊，請參閱 /debug （C# 編譯程式選項） 或 /debug （Visual Basic）。

C/C++ 選項

• VC<x>.pdb 和 <專案>.pdb 檔案

  當您使用 /ZI 或 /Zi建置時，會建立 C/C++的 .pdb 檔案。 在 Visual C++ 中，/Fd 選項會將編譯程式所建立 .pdb 檔案命名為 。 當您使用 IDE 在 Visual Studio 中建立專案時，/Fd 選項會設定為建立名為 .pdb 的 < 檔案。

  如果您使用 makefile 建置 C/C++ 應用程式，且指定 /ZI 或 /Zi，但沒有使用 /Fd 來指定檔名，編譯器會建立兩個 .pdb 檔案：

  • VC<x>.pdb，其中 <x> 代表 Microsoft C++ 編譯程式的版本，例如 VC11.pdb

    VC<x>.pdb 檔案會儲存個別物件檔案的所有偵錯資訊，且位於與專案 makefile 相同的目錄中。 每次建立物件檔時，C/C++編譯程式會將偵錯資訊合併至 VC<x>.pdb。 因此，即使每個來源檔案都包含一般頭檔，例如 <windows.h>，來自這些標頭的 typedefs 只會儲存一次，而不是儲存在每個對象檔中。 插入的資訊包括類型資訊，但不包含符號資訊，例如函式定義。

  • <專案>.pdb

    <專案>.pdb 檔案會儲存專案 .exe 檔案的所有偵錯資訊，並位於 \debug 子目錄中。 <專案>.pdb 檔案包含完整的偵錯資訊，包括函式原型，而不只是在 VC<x>.pdb中找到的類型資訊。

  VC<x>.pdb 和 <項目>.pdb 檔案都允許累加式更新。 鏈接器也會在所建立 .exe 或 .dll 檔案中內嵌 .pdb 檔案的路徑。

• DLL 匯出數據表

  使用 dumpbin /exports 來查看 DLL 匯出資料表中可用的符號。 DLL 匯出表中的符號資訊對於處理 Windows 訊息、Windows 程式（WindowProcs）、COM 物件、封送處理，或任何您沒有符號的 DLL 都非常有用。 符號適用於任何 32 位系統 DLL。 目前的呼叫順序是從底層到頂層排列，最深巢狀的目前函式位於最上方。

  透過讀取 dumpbin /exports 輸出，您可以看到確切的函數名稱，包括非英數字元。 查看確切的函式名稱對於在函式上設定斷點很有用，因為函式名稱可以在調試程式的其他位置截斷。 如需詳細資訊，請參閱 dumpbin /exports。

Web 應用程式

將 ASP.NET 應用程式的 web.config 檔案設定為偵錯模式。 偵錯模式會導致 ASP.NET 產生動態產生的檔案符號，並讓調試程式附加至 ASP.NET 應用程式。 如果您從 Web 專案範本建立專案，Visual Studio 會在您開始偵錯時自動設定此設定。

偵錯時載入符號

您可以使用 模組、呼叫堆疊、局部變數、自動或任何 監看 視窗載入符號，或在偵錯時變更符號選項。 如需詳細資訊，請參閱 深入瞭解調試程式如何附加至您的應用程式。

在 [模組] 視窗中使用符號

在偵錯期間，[模組] 視窗會顯示偵錯工具視為使用者程式碼或「我的程式碼」的程式碼模組，以及其符號載入狀態。 您也可以在 [模組] 視窗中監視符號載入狀態、載入符號，以及變更符號選項。

偵錯時監視或變更符號位置或選項：

1. 若要開啟 [模組] 視窗，請在偵錯時選取 [偵錯>Windows>模組] （或 按 ctrl + Alt + U）。

2. 在 [模組] 視窗中，以滑鼠右鍵按兩下 符號狀態 或 符號檔 標頭或任何模組。

3. 在操作功能表中，選取下列其中一個選項：

   選擇	描述
   載入符號	針對已略過、找不到或未載入符號的模組顯示。 嘗試從「工具>選項」窗格中指定的位置載入符號，該位置位於「所有設定>」「偵錯>符號搜尋>」和「載入」或「搜尋位置」區段下。 如果找不到或未載入符號檔案，則會啟動 檔案總管， 讓您可以指定要搜尋的新位置。
   符號載入資訊	顯示載入符號檔案的位置，或偵錯工具找不到檔案時搜尋的位置。
   符號設定	開啟 [工具>選項] 窗格，以進入 [ 所有設定>偵錯符號>搜尋>位置 ] 區段，您可以在其中編輯和新增符號位置。
   總是自動載入	將選取的符號檔新增至調試程式自動載入的檔案清單。
   將來源分解為符號檔	針對 .NET 程式代碼，您可以選擇此選項，然後遵循 產生和內嵌元件來源中的指示。

使用未載入符號頁面/未載入來源頁面

偵錯工具有數種方式可以分斷成沒有符號或原始檔的程式碼：

• 投入編程。
• 從斷點或例外狀況中斷程序代碼。
• 切換至不同的線程。
• 雙擊 呼叫堆疊 窗口中一個框架，以變更堆疊框架。

發生這種情況時，調試程式會顯示 未載入符號 或 未載入來源 頁面，以協助您尋找和載入必要的符號或來源。

若要使用 [尚未載入的符號] 文件頁面來協助尋找和載入遺漏的符號：

• 若要變更搜尋路徑，請選取未選取的路徑，或選取 [新路徑] 或 [新增 VSTS 路徑]，然後輸入或選取新的路徑。 選取 [載入] 以再次搜尋路徑，並在找到符號檔時載入符號檔。

• 若要覆蓋任何符號選項並重試搜尋路徑，請選取 [瀏覽]，然後尋找 <可執行檔名稱>。 如果找到符號檔，則會載入符號檔，或開啟檔案 總管， 以便您可以手動選取符號檔。

• 若要開啟符號設定頁面以設定行為，請選取 [變更符號設定 ] （或開啟 [工具>選項] 窗格，然後移至 [ 所有設定>] 偵錯>符號搜尋>和載入 或 [搜尋位置 ] 區段）。

• （進階）若要在新視窗中顯示一次反組譯，請選取 檢視反組譯，或選取 「選項對話方塊」 ，將選項設定為在找不到來源或符號檔時一律顯示反組譯。 如需詳細資訊，請參閱 檢視反組譯碼。

• 若要顯示搜尋的位置和結果，請展開 符號載入資訊。

• 針對 C# 程式代碼，您也可以選擇 從 未載入符號 或 未載入來源 頁面來反編譯 原始程式碼。

如果調試程式在執行其中一個選項之後找到 .pdb 檔案，而且可以使用 .pdb 檔案中的資訊來擷取來源檔案，則會顯示來源。 否則，它會顯示 [未載入來源] 頁面，其中包含可能解決問題的資訊和動作連結。

若要將來源檔案搜尋路徑新增至解決方案：

您可以指定調試程式搜尋來源檔案的位置，並從搜尋中排除特定檔案。

1. 在 [方案總管 ]中選取方案，然後選取 [屬性] 圖示、按 Alt+Enter，或以滑鼠右鍵按兩下 ，然後選取 [屬性]。

2. 選取 偵錯來源檔案。

   

3. 在包含原始程式碼的 目錄中，輸入或選取要搜尋的原始碼位置。 使用 新行 圖示來新增更多位置，向上 和 向下 箭頭圖示來重新排序它們，或 X 圖示加以刪除。

   注意

   調試程式只會搜尋指定的目錄。 您必須為任何想要搜尋的子目錄新增條目。

4. 在 [[不要尋找這些來源檔案]下，輸入要從搜尋中排除的來源檔名。

5. 選取 [確定] 或 [套用]。

相關內容

• 瞭解符號檔和 Visual Studio 符號設定