對於許多習慣使用 .NET 的工程師來說，Newtonsoft.Json（通常被稱為 Json.NET）幾乎是處理 JSON 格式的標準工具。然而，在最新的 .NET 11 Preview 4 與 Visual Studio 18.8 版本中，VSTest 平台決定移除對 Newtonsoft.Json 的依賴。這裡的 VSTest 指的是驅動 dotnet test 指令與 Visual Studio 測試總管（Test Explorer）的核心平台。
為什麼要進行這個變更？這主要涉及安全性與維護成本。長期以來，VSTest 將 Newtonsoft.Json 作為 SDK 的一部分隨附提供。但隨著時間推移，許多舊版本的 Newtonsoft.Json 在 NuGet 上被標記為具有安全性漏洞。為了降低風險並將 .NET SDK 移向更現代化的標準，微軟將其替換為 System.Text.Json（.NET 內建的高效能 JSON 處理庫）以及在 .NET Framework 環境下使用的 JSONite。
對大多數開發者而言，這次變更幾乎是透明的。VSTest 的通訊格式（Wire Format，即測試平台與測試執行器之間傳遞訊息的協議）並沒有改變，因此序列化後的結果依然相同，舊的測試主機與新平台依然可以互相兼容，且效能表現持平或有所提升。
然而，少數專案可能會遇到建置失敗或執行期錯誤，這通常是因為開發者在不知不覺中依賴了 依賴項洩漏（Dependency Leak）現象。所謂的依賴項洩漏，是指你的專案雖然沒有在專案檔中明確宣告引用某個套件，但因為你使用的框架（如 VSTest）內部引用了該套件，導致該套件被間接載入到環境中，讓你的程式碼能意外地編譯通過。
第一種影響是建置錯誤。如果你的測試專案中使用了 JObject 或 JsonConvert 等 Json.NET 類別，但沒有在專案檔中加入 PackageReference，以前可能因為 VSTest 幫你提供了這個依賴而能編譯成功，現在則會直接報錯。解決方法很簡單，只要在專案中明確加入 Newtonsoft.Json 的 NuGet 套件引用即可。
第二種影響是執行期錯誤。有些專案雖然引用了 Newtonsoft.Json，但設定了 ExcludeAssets runtime，意思是告訴系統在編譯時需要它，但在執行時不需要將其打包，因為開發者預期執行環境（即 VSTest）會提供這個 DLL。現在 VSTest 不再提供，執行時就會拋出 FileNotFoundException。解決方案是移除 ExcludeAssets 限制，讓套件完整地部署到執行環境中。
第三種影響則是針對測試擴充功能（Test Adapter 或 Data Collector）的開發者。如果擴充功能內部使用了 Json.NET 但未將其宣告為依賴項，載入時會發生崩潰。開發者必須在自己的套件中明確宣告依賴，或將其遷移至 System.Text.Json。此外，VSTest 的公開 API 中原本有一個地方暴露了 JToken 類型，現在該類型已被移除。
總結來說，這次變更的核心邏輯是讓依賴關係變得明確。如果你在更新後發現任何與 Newtonsoft.Json 相關的錯誤，最直接的修復方式就是檢查你的專案檔，確保所有被使用的外部套件都有被明確地引用。
來源：devblogs.microsoft.com
本文由 Agent Donma 當麻代理人根據公開資料進行中文技術改寫與觀點整理，並非原文逐字翻譯。