Visual Studio Code 中的 NuGet
NuGet 是 .NET 的包管理器。它定義瞭如何建立、託管和使用 .NET 的包,同時為這些功能中的每一項提供了工具。NuGet 還代表專案管理依賴關係樹,因此你只需關注專案中直接使用的包。
在 Visual Studio Code 中,你可以直接從 C# 開發工具包解決方案資源管理器管理 NuGet 包,也可以使用命令面板進行管理。
若要詳細瞭解 NuGet,請訪問 NuGet 文件。
C# 開發工具包中的 NuGet 命令
在 C# 開發工具包中,你可以透過以下兩種方式之一執行 NuGet 包操作:
-
使用命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P))
-
在 C# 開發工具包解決方案資源管理器中右鍵單擊
以下各節介紹如何使用這兩種方法來使用每個 NuGet 命令。
新增包
-
若要將 NuGet 包新增到專案,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Add NuGet Package。
-
如果解決方案中有多個專案,系統會要求你選擇要將包新增到哪個專案。
-
接下來,輸入搜尋詞以按名稱搜尋 NuGet 包。
“快速選取”會顯示一個可供選擇的 NuGet 包示例列表。
-
接下來,選擇要應用的版本。
-
選擇包和版本號後,C# 開發工具包會將其新增到你的專案中,並更新你的專案檔案和引用。
更新包
-
若要更新專案中的 NuGet 包,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Update NuGet Package。
-
如果解決方案中有多個專案,系統會要求你選擇包含要更新的包的專案。
-
接下來,從專案中當前已安裝且有可用更新的包列表中,選擇要更新的包。如果解決方案中沒有包有可用更新,你將看到一條通知此情況的訊息。
-
最後,你可以從可用版本的下拉列表中選擇要將包更新到的版本。
-
然後,C# 開發工具包會執行必要的更改並更新你的專案檔案和引用。
刪除包
-
若要從專案中刪除 NuGet 包,請在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用命令 NuGet: Remove NuGet Package。
-
如果解決方案中有多個專案,系統會要求你選擇要從中刪除包的專案。
-
接下來,從專案中當前已安裝的包列表中,選擇要刪除的包。
-
然後,C# 開發工具包會執行必要的更改並更新你的專案檔案和引用。
包括預發行包版本
如果你希望更新或新增 NuGet 包的預發行版本,首先需要將 Include Prerelease Package Versions 設定為 true。
你可以在 File > Preferences > Settings (⌘, (Windows, Linux Ctrl+,)) 下找到此選項,並將 nuget.includePrereleasePackageVersions
搜尋並設定為 true
。
依賴項管理
自動 NuGet 還原
對於 .NET 專案,當你從模板建立專案、生成、載入或對 SDK 風格的專案進行更改時,會自動進行包還原。你可以在“輸出”面板中檢視進度和日誌。
對於使用 <PackageReference>
的專案,你可以在 Visual Studio Code 的解決方案資源管理器部分檢視包引用。
在還原或執行生成時未能正確安裝的包,將在解決方案資源管理器中顯示錯誤圖示。
注意:目前,你無法透過右鍵單擊專案來管理 NuGet 包,並且 Visual Studio Code 中沒有 NuGet 包管理器使用者介面。
有關管理包的更多資訊,請參閱使用 dotnet CLI 安裝和管理 NuGet 包。