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

你可以在 Windows、macOS 或 Linux 上使用 dotnet 命令列介面(CLI)工具,輕鬆安裝、卸載及更新 .NET 專案與解決方案中的 NuGet 套件。 本文說明管理 NuGet 套件的最常見 dotnet CLI 命令。

dotnet CLI 可運行於 .NET、.NET 核心、.NET Standard SDK 風格專案,以及其他任何 SDK 風格專案,例如針對 .NET Framework 的專案。 如需詳細資訊,請參閱 .NET 專案 SDK。

對於大部分的命令,CLI 工具會在目前目錄中尋找專案檔,除非在命令中將不同的專案檔指定為選用參數。 如需命令及其引數的完整清單,請參閱 dotnet CLI 命令。

先決條件

提供 dotnet CLI 的 .NET SDK。 在 Visual Studio 中,dotnet CLI 會自動安裝所有與 .NET 相關的工作負載。

安裝或更新套件

dotnet 套件的 add 指令會為專案檔案新增一個套件參考,然後執行dotnet restore以安裝該套件。

  1. 打開命令列視窗,進入包含你專案檔案的目錄。

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

    dotnet package add <package-name>
    

    例如,要安裝套件 Newtonsoft.Json ,請使用以下指令:

    dotnet package add Newtonsoft.Json
    

    如果你使用的是 .NET 9 或更早版本,請改用動詞優先的形式:

    dotnet add package <package-name>
    
  3. 指令完成後,打開專案檔案檢查套件引用。

    例如,打開 .csproj 檔案,檢查新增 Newtonsoft.Json 的套件參考:

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

安裝特定版本的套件

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

若要安裝特定版本的 NuGet 套件,請使用選擇性 -v or --version 參數:

dotnet package add <package-name> -v <version>

例如,要新增套件的版本 13.0.1 Newtonsoft.Json ,請使用以下指令:

dotnet package add Newtonsoft.Json --version 13.0.1

列出程式包參考

你可以使用 dotnet 套件列表 指令列出專案的套件參考和版本。 從包含你專案檔案的目錄中,執行以下指令:

dotnet package list

如果你使用的是 .NET 9 或更早版本,請改用動詞優先的形式:

dotnet list package

移除套件

你可以使用 dotnet 套件的 remove 指令,從專案檔案中移除套件參考。 從包含你專案檔案的目錄中,執行以下指令:

dotnet package remove <package-name>

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

dotnet package remove Newtonsoft.Json

如果你使用的是 .NET 9 或更早版本,請改用動詞優先的形式:

dotnet remove package <package-name>

恢復套件

此 dotnet restore 指令用來還原專案 <PackageReference> 檔案中元素中列出的套件。 欲了解更多資訊,請參閱 PackageReference 專案檔案。

從 .NET Core 2.0 開始到 .NET,dotnet build 和 dotnet run 指令會自動還原套件,許多其他 dotnet CLI 指令也是如此。 從 NuGet 4.0 開始,執行 dotnet restore 的程式碼與 nuget restore NuGet CLI 指令相同。

使用dotnet restore來還原套件:

  1. 打開命令列視窗,進入包含你專案檔案的目錄。
  2. 執行 dotnet restore。