使用 dotnet CLI 安裝及管理 NuGet 套件

  • 發行項

您可以在 Windows、macOS 或 Linux 上使用 dotnet CLI 工具，輕鬆地在 .NET 專案和方案中安裝、卸載及更新 NuGet 套件。 本文說明管理 NuGet 套件的最常見 dotnet CLI 命令。

dotnet CLI 會在 .NET、.NET Core、.NET Standard SDK 樣式專案，以及任何其他 SDK 樣式專案上執行，例如以 .NET Framework 為目標的專案。 如需詳細資訊，請參閱 .NET 專案 SDK。

在大部分的命令中，CLI 工具會尋找目前目錄中的項目檔，除非命令中將不同的項目檔指定為選擇性參數。 如需命令及其自變數的完整清單，請參閱 dotnet CLI 命令。

必要條件

  • .NET Core SDK，它會提供 dotnet 命令列工具。 從 Visual Studio 2017 開始，dotnet CLI 會自動安裝所有 .NET 和 .NET Core 相關工作負載。

安裝或更新套件

dotnet add package 命令會將套件參考新增至專案檔，然後執行 dotnet restore 以安裝套件。

  1. 開啟命令列並切換至包含您專案檔的目錄。

  2. 使用下列命令來安裝 NuGet 套件：

    dotnet add package <PACKAGE_NAME>

    例如，若要安裝 Newtonsoft.Json 套件，請使用下列命令

    dotnet add package Newtonsoft.Json

  3. 命令完成之後，您可以開啟項目檔來查看套件參考。

    例如，開啟 .csproj 檔案以查看新增 Newtonsoft.Json 的套件參考：

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

安裝特定版本的套件

除非您指定不同的版本，否則 dotnet add package 命令會安裝最新版本的套件。

若要安裝特定版本的 NuGet 套件，請使用選擇性 -v 或 --version 參數：

dotnet add package <PACKAGE_NAME> -v <VERSION>

例如，若要新增 12.0.1 版的 Newtonsoft.Json 套件，請使用此命令：

dotnet add package Newtonsoft.Json --version 12.0.1

列出套件參考

使用 dotnet list package 命令列出專案的套件參考和版本：

dotnet list package

移除套件

使用 dotnet remove package 命令來移除專案檔中的套件參考。

dotnet remove package <PACKAGE_NAME>

例如，若要移除 Newtonsoft.Json 套件，請使用下列命令：

dotnet remove package Newtonsoft.Json

還原套件

dotnet restore 命令會使用 還原項目檔所列出的<PackageReference>套件。 如需詳細資訊，請參閱 項目檔中的 PackageReference。

.NET Core 2.0 和更新版本 dotnet build 和 dotnet run 命令會自動還原套件。 從 NuGet 4.0 起，執行 dotnet restore 與 nuget restore相同的程式代碼。

若要使用 dotnet restore還原套件：

  1. 開啟命令列並切換至包含您專案檔的目錄。
  2. 執行 dotnet restore。

下一步