/DEBUG （產生偵錯資訊）

連結 /DEBUG 器選項會建立可執行檔的偵錯信息檔。

語法

/DEBUG[:{FASTLINK||FULLNONE}]

備註

選項 /DEBUG 會將連結物件和連結庫檔案中的偵錯資訊放入程式資料庫 （PDB） 檔案中。 它會在後續的程式建置期間更新 PDB。

為了偵錯而建立的可執行檔（EXE 或 DLL 檔案）包含對應 PDB 的名稱和路徑。 當您對程式偵錯時，偵錯工具會讀取內嵌名稱，並使用 PDB。 鏈接器會使用程式的基底名稱和延伸模組 .pdb 來命名程式資料庫，並內嵌其建立所在的路徑。 若要覆寫此預設值，請設定 /PDB 選項並指定不同的檔名。

此選項 /DEBUG:FASTLINK 可在Visual Studio 2017和更新版本中使用。 此選項會產生有限的 PDB，以編製物件檔和連結庫中用來建置可執行文件的偵錯資訊索引，而不是建立完整複本。 您只能使用這個有限的 PDB 從建立二進位檔及其連結庫的電腦進行偵錯。 如果您在其他地方部署二進位檔，您可以從組建計算機遠端偵錯它，但不直接在測試計算機上進行偵錯。 自 Visual Studio 2019 以來， /DEBUG:FULL 鏈接時間已大幅改善，而且 /DEBUG:FASTLINK 不一定比 更快 /DEBUG:FULL。 由於 /DEBUG:FASTLINK 不再提供大型建置時間改善，因此與的偵錯體驗較 /DEBUG:FULL慢，因此不再建議使用此選項。

/DEBUG:FASTLINK PDB 可以轉換成完整的 PDB，您可以部署至測試機器進行本機偵錯。 在 Visual Studio 中，使用 [屬性頁 ] 對話方塊，如下所述，為專案或解決方案建立完整的 PDB。 在開發人員命令提示字元中 mspdbcmf.exe ，您可以使用工具來建立完整的 PDB。

此選項會將 /DEBUG:FULL 所有私人符號資訊從個別編譯產品（物件檔案和連結庫）移至單一 PDB，而且可能是連結最耗時的部分。 不過，在沒有任何其他組建產品可用時 (例如在部署可執行檔時)，完整 PDB 可用來偵錯可執行檔。

此選項 /DEBUG:NONE 不會產生 PDB。

沒有 /DEBUG 額外自變數的指定，相當於指定 /DEBUG:FULL。

編譯程式的 /Z7 [C7 兼容] 選項會導致編譯程式將偵錯資訊保留在物件 （OBJ） 檔案中。 您也可以使用 /Zi [程序資料庫] 編譯程式選項，將偵錯資訊儲存在 OBJ 檔案的 PDB 中。 鏈接器會先在 OBJ 檔案中寫入的絕對路徑中尋找物件的 PDB，然後在包含 OBJ 檔案的目錄中尋找該物件的 PDB。 您無法指定物件的 PDB 檔案名稱或連結器位置。

/INCREMENTAL 指定 時 /DEBUG 為隱含。

/DEBUG設定預設/OPT值從 REF 變更NOREFICF為 NOICF，因此如果您要原始預設值，則必須在 選項之後/DEBUG明確指定 /OPT:REF 或 /OPT:ICF 。

無法建立包含偵錯資訊的 EXE 或 DLL。 偵錯資訊一律放在 OBJ 或 PDB 檔案中。

在 Visual Studio 開發環境中設定這個連結器選項

1. 開啟專案的 [屬性頁] 對話方塊。 如需詳細資料，請參閱在 Visual Studio 中設定 C ++ 編譯器和組建屬性。

2. 選取 [鏈接器偵>錯] 屬性頁。

3. 修改 [ 產生偵錯資訊 ] 屬性，以啟用或停用 PDB 產生。 此屬性預設會在 Visual Studio 2017 和更新版本中啟用 /DEBUG:FASTLINK 。

4. 修改 [ 產生完整程序資料庫檔案 ] 屬性，以針對每個累加組建啟用 /DEBUG:FULL 完整的 PDB 產生。

若要以程式設計方式設定這個連結器選項

1. 請參閱 GenerateDebugInformation。

另請參閱

MSVC 連結器參考
MSVC 連結器選項