來源連結
來源連結技術可讓開發人員對來自 NuGet 的 .NET 組件進行原始程式碼偵錯。 來源連結會在建立 NuGet 套件時執行,並將原始程式碼控制中繼資料內嵌在組件和套件。 下載套件並在 Visual Studio 中啟用來源連結的開發人員可以逐步執行原始程式碼。 來源連結提供原始程式碼控制中繼資料來建立絕佳的偵錯體驗。
來源連結示範
使用來源連結
使用來源連結的指示位於 dotnet/sourceLink GitHub 存放庫。
您可以使用 NuGet 套件總管桌面應用程式或 nuget.info 網站確認來源連結中繼資料已成功內嵌在套件中。 確認 Repository
中繼資料存在並具有認可識別碼,且 .pdb 檔案與每個目標的 .dll 在一起。
✔️ 請考慮使用來源連結以將原始程式碼控制中繼資料新增到您的組件與 NuGet 套件。
提示
您可以將偵錯工具屬性新增至您的類型,進一步加強開發人員的偵錯體驗。
- DebuggerDisplayAttribute 可以自訂類別或欄位在偵錯工具變數視窗中顯示的方式。
- DebuggerStepThroughAttribute 指示偵錯工具逐步執行程式碼,而不要進入程式碼。
- DebuggerBrowsableAttribute 控制成員是否要顯示在偵錯工具變數視窗中。
✔️ 請考慮發佈符號檔案 (*.pdb
)。
如需最佳偵錯體驗,您的程式庫應該發佈符號檔,以及使用來源連結。 如需有關符號檔和符號套件的詳細資訊,請參閱符號套件。
✔️ 請考慮啟用決定性組建。
決定性組建可驗證產生的二進位檔是從指定的來源建置,並提供可追蹤性。 如需決定性組建和啟用這些組建的指示詳細資訊,請參閱確定性組建。