使映像更容易在 .NET 中進行偵錯
注意
本文專屬於 .NET Framework。 其不適用於較新的 .NET 實作，包括 .NET 6 和更新版本。
當編譯 Unmanaged 程式碼時，您可以設定 IDE 參數或命令列選項，設定可執行映像進行偵錯。 例如，您可以在 Visual C++ 中使用 /Zi 命令列選項，要求它發出偵錯符號檔 (副檔名為 .pdb)。 同樣地，/Od 命令列選項會通知編譯器停用最佳化。 要是此為必要，產生的程式碼執行速度較慢，但更容易偵錯。
當編譯 .NET Framework 受控程式碼時，Visual C++、Visual Basic 和 C# 等編譯器會將其原始程式編譯成通用中間語言 (CIL)。 CIL 會在剛好執行前，以 JIT 方式編譯為原生機器碼。 如同使用 Unmanaged 程式碼一樣，您可以設定 IDE 參數或命令列選項，設定可執行映像進行偵錯。 您可以極近似的方式設定 JIT 編譯進行偵錯。
JIT 組態有兩個層面：
您可以要求 JIT 編譯器產生追蹤資訊。 這可讓偵錯工具的機器碼對應項目對應上 CIL 鏈結，追蹤本機變數和函式引數的儲存位置。 在 .NET Framework 2.0 和更新版本中，JIT 編譯器一律會產生追蹤資訊，因此不需要提出要求。
您可以要求 JIT 編譯器不要最佳化產生的機器碼。
一般來說，產生 CIL 的編譯器會根據您指定的 IDE 參數或命令列選項，例如，/Od，適當地設定 JIT 編譯器選項。
在某些情況下，您可能想要變更 JIT 編譯器的行為，以便更容易偵錯它產生的機器碼。 例如，您可能想要產生零售組建的 JIT 追蹤資訊，或控制最佳化。 您可以使用初始設定 (.ini) 檔案完成此作業。
例如，如果您想要偵錯的組件稱為 MyApp.exe，則可以在和 MyApp.exe 相同的資料夾中，建立名為 MyApp.ini 的文字檔，包含這三行：
[.NET Framework Debugging Control]
GenerateTrackingInfo=1
AllowOptimize=0
每個選項的值可以設成 0 或 1，任何不存在的選項預設值皆為 0。 將 GenerateTrackingInfo 設為 1、AllowOptimize 設為 0，會提供最簡單的偵錯。
從 .NET Framework 2.0 開始，JIT 編譯器一律會產生追蹤資訊，無論 GenerateTrackingInfo 的值為何；不過，AllowOptimize 值仍然會有效果。 當使用 Ngen.exe (原生映像產生器) 先行編譯未最佳化的原生映像時，在執行 Ngen.exe 時，.ini 檔案中必須位在目標資料夾中且附有 AllowOptimize=0。 如已先行編譯未最佳化的組件，您必須先使用 NGen.exe /uninstall 選項移除先行編譯的程式碼，再重新執行 Ngen.exe 先行編譯最佳化的程式碼。 如果資料夾中沒有 .ini 檔案，Ngen.exe 預設會將程式碼先行編譯為最佳化。
System.Diagnostics.DebuggableAttribute 控制組件的設定。 DebuggableAttribute 包含兩個欄位，控制 JIT 編譯器是否應該最佳化，及/或是否產生追蹤資訊。 在 .NET Framework 2.0 和更新版本中，JIT 編譯器一律會產生追蹤資訊。
編譯器不會為零售組建設定任何 DebuggableAttribute。 依預設，JIT 編譯器會產生最高的效能，幾乎不對機器碼進行偵錯。 啟用 JIT 追蹤會略降低效能，而停用最佳化則會大幅降低效能。
DebuggableAttribute 是一次套用至整個組件，不是一一套用到組件中的個別模組。 因此，開發工具必須將自訂屬性附加至組件中繼資料權杖 (如已建立組件)，或附加至稱為 System.Runtime.CompilerServices.AssemblyAttributesGoHere 的類別。 接著，ALink 工具會將這些 DebuggableAttribute 屬性從每個模組升級至其所屬的組件。 如果發生衝突，ALink 作業就會失敗。
注意
在 .NET Framework 1.0 版中，當指定 /clr 和 /Zi 編譯器選項時，Microsoft Visual C++ 編譯器會新增 DebuggableAttribute。 在 .NET Framework 1.1 版中，您必須在程式碼中手動新增 DebuggableAttribute，或使用 /ASSEMBLYDEBUG 連結器選項。
