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 コマンドを参照してください。

[前提条件]

dotnet CLI を提供する .NET SDK です。 Visual Studioでは、dotnet CLI はすべての.NET関連ワークロードと共に自動的にインストールされます。

パッケージをインストールまたは更新する

dotnet package 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 または --version スイッチを使用します。

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

たとえば、 Newtonsoft.Json パッケージのバージョン 13.0.1 を追加するには、次のコマンドを使用します。

dotnet package add Newtonsoft.Json --version 13.0.1

パッケージ参照の一覧表示

dotnet package list コマンドを使用して、プロジェクトのパッケージ参照とバージョンを一覧表示できます。 プロジェクト ファイルを含むディレクトリから、次のコマンドを実行します。

dotnet package list

.NET 9 以前を使用している場合は、代わりに動詞優先形式を使用します。

dotnet list package

パッケージを削除する

dotnet package 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 CLI コマンドと同様に、dotnet build コマンドと dotnet run コマンドによってパッケージが自動的に復元されます。 NuGet 4.0 以降、 dotnet restore は nuget restore NuGet CLI コマンドと同じコードを実行します。

dotnet restoreを使用してパッケージを復元するには:

  1. コマンド ライン ウィンドウを開き、プロジェクト ファイルを含むディレクトリに移動します。
  2. dotnet restore を実行します。

関連するコンテンツ

  • Last updated on