nuget.exe CLI ツールを使用して、Visual Studio プロジェクトとソリューションで NuGet パッケージを管理できます。 この記事では、NuGet パッケージを管理するための最も一般的な NuGet CLI コマンドについて説明します。 これらのコマンドはすべて Windows で動作し、ほとんどのコマンドは Mac と Linux と Mono で動作します。
NuGet CLI は、.NET Standard ライブラリを対象とする SDK 以外のスタイルのプロジェクトなど、.NET Framework および SDK 以外のスタイルのプロジェクトで実行されます。 NuGet CLI コマンドでは、パッケージ参照を一覧表示するプロジェクト packages.config ファイルを使用できます。 パッケージ参照にpackages.configの代わりに PackageReference を使用する SDK スタイル 以外のプロジェクト の場合は、代わりに dotnet CLI を 使用します。
注
packages.configを使用する SDK スタイル以外のほとんどのプロジェクトでは、packages.config を PackageReference に移行してから、NuGet CLI ではなく dotnet CLI を使用してパッケージを管理することをお勧めします。 ただし、C++ または ASP.NET プロジェクトを移行することはできません。
ほとんどのコマンドでは、コマンドで別の場所を指定しない限り、NuGet CLI ツールは現在のディレクトリを使用します。 NuGet CLI コマンドを実行するには、コマンド ラインを開き、プロジェクト ファイルを含むディレクトリに切り替えます。
コマンドとその引数の完全な一覧については、 NuGet CLI リファレンスを参照してください。
[前提条件]
nuget.org から NuGet CLI をダウンロードします。nuget.exe ファイルを適切なディレクトリに保存し、ディレクトリが PATH 環境変数にあることを確認します。
注
Windows 用の winget ツールや macOS 用 の Homebrew を使用することもできます。
NuGet CLI のバージョンを確認するには、コマンド ラインを開いて nuget help実行するか、上にスクロールする必要がないようにするには、 nuget help | moreを使用します。 ヘルプ出力の最初の行にバージョンが表示されます。
パッケージをインストールする
NuGet CLI インストール コマンドは、指定された NuGet パッケージをダウンロードしてインストールします。
Important
install コマンドでは、プロジェクト ファイルや packages.config ファイルは変更されません。
installコマンドとrestore コマンドは、パッケージをディスクにのみ追加しますが、プロジェクトには依存関係を追加しません。 プロジェクトの依存関係を追加するには、 Visual Studio パッケージ マネージャー UI または パッケージ マネージャー コンソールを使用してパッケージを追加し、 install または restoreを実行します。
特定のディレクトリにパッケージをインストールするには、 -OutputDirectory オプションを使用します。 出力ディレクトリを指定しない場合、 install は現在のディレクトリを使用します。
nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>
たとえば、 Newtonsoft.json パッケージを packages サブディレクトリにインストールするには、次のコマンドを使用します。
nuget install Newtonsoft.Json -OutputDirectory packages
インストールするパッケージを指定する代わりに、現在のディレクトリまたは別のディレクトリに既存の packages.config ファイルを指定できます。
install コマンドは、packages.config ファイルに一覧表示されているすべてのパッケージをインストールします。
nuget install packages.config
たとえば、次のコマンドは、config サブディレクトリの packages.config に一覧表示されているすべてのパッケージを packages サブディレクトリにインストールします。
nuget install config\packages.config -OutputDirectory packages
パッケージの特定のバージョンをインストールする
install コマンドは、別のバージョンを指定しない限り、パッケージの最新バージョンをインストールします。 パッケージの特定のバージョンをインストールするには、 -Version オプションを使用します。
nuget install <packageID | configFilePath> -Version <version>
たとえば、 Newtonsoft.json パッケージのバージョン 12.0.1 をインストールするには、次のコマンドを使用します。
nuget install Newtonsoft.Json -Version 12.0.1
パッケージを一覧表示する
list コマンドを使用して、パッケージ フォルダーにインストールされているパッケージの一覧を表示します。 リストを制限するには、 -Source オプションを使用します。
nuget list -Source <source>
たとえば、MyProject の packages サブディレクトリにパッケージを一覧表示するには、次のコマンドを使用します。
nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages
検索用語を使用して、パッケージ名、タグ、または説明を検索することもできます。
nuget list <"search term"> -Source <source>
すべてのパッケージを更新する
update コマンドを使用して、プロジェクト packages.config ファイル内のすべてのパッケージを使用可能な最新バージョンに更新します。
restoreを実行する前に、updateを実行することをお勧めしています。
nuget update
パッケージを削除する
パッケージを削除するには、プロジェクト フォルダーからそのパッケージを削除します。 パッケージを再インストールするには、 restore または install コマンドを使用します。
ディスクからパッケージを削除しても、プロジェクト、 packages.config、または NuGet.Config ファイルは更新されません。 パッケージを削除する最善の方法は、Visual Studio パッケージ マネージャー UI または パッケージ マネージャー コンソールを使用することです。
パッケージの復元
NuGet CLI 復元 コマンドは、不足しているパッケージをダウンロードしてインストールします。 このコマンドは、 PackageReference またはパッケージ 参照 にpackages.config を使用するプロジェクトで動作します。
installと同様に、restore コマンドはパッケージをディスクにのみ追加しますが、プロジェクト ファイルや packages.configは変更しません。プロジェクトの依存関係を追加するには、Visual Studio パッケージ マネージャー UI またはコンソールを使用します。
パッケージを復元するには、次のコマンドを実行します。
nuget restore <projectPath>
restore コマンドは、指定したプロジェクト パス内のソリューション ファイルまたは package.config ファイルを使用します。
たとえば、現在のディレクトリ内の MySolution.sln のすべてのパッケージを復元するには、次のコマンドを実行します。
nuget restore MySolution.sln
注
PackageReferenceを使用する SDK スタイル以外のプロジェクトの場合は、代わりに msbuild -t:restore を使用してパッケージを復元します。
詳細については、「パッケージの 復元」を参照してください。