Installieren und Verwalten von NuGet-Paketen mit dotnet CLI

  • Artikel

Sie können das dotnet CLI-Tool unter Windows, macOS oder Linux verwenden, um NuGet-Pakete in .NET-Projekten und -Lösungen auf einfache Weise zu installieren, zu deinstallieren und zu aktualisieren. In diesem Artikel werden die gängigsten dotnet CLI-Befehle zum Verwalten von NuGet-Paketen beschrieben.

Die dotnet CLI wird auf .NET-, .NET Core-, .NET Standard SDK-Stil-Projekten und anderen SDK-Formatprojekten ausgeführt, z. B. für .NET Framework-Projekte. Weitere Informationen finden Sie unter .NET-Projekt-SDKs.

Bei den meisten Befehlen sucht das CLI-Tool nach einer Projektdatei im aktuellen Verzeichnis, sofern keine andere Projektdatei als optionaler Schalter im Befehl angegeben ist. Eine vollständige Liste der Befehle und deren Argumente finden Sie unter dotnet CLI-Befehle.

Voraussetzungen

  • Das .NET Core SDK, das das Befehlszeilentool dotnet bereitstellt. Ab Visual Studio 2017 wird die dotnet CLI automatisch mit jeder .NET und .NET Core-bezogenen Workload installiert.

Installieren oder Aktualisieren eines Pakets

Über dotnet add package wird ein Paketverweis auf die Projektdatei hinzugefügt, anschließend wird dotnet restore ausgeführt, um das Paket zu installieren.

  1. Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.

  2. Verwenden Sie folgenden Befehl, um ein NuGet-Paket zu installieren:

    dotnet add package <PACKAGE_NAME>

    Verwenden Sie beispielsweise zum Installieren des Newtonsoft.Json-Pakets den folgenden Befehl:

    dotnet add package Newtonsoft.Json

  3. Nachdem der Befehl abgeschlossen wurde, können Sie die Projektdatei öffnen, um den Paketverweis zu sehen.

    Öffnen Sie z. B. die .csproj-Datei, um die hinzugefügte Newtonsoft.Json-Paketreferenz anzuzeigen:

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

Installieren einer bestimmten Paketversion

Mit dem Befehl dotnet add package wird die neueste Version des Pakets installiert, wenn keine andere Version angegeben wird.

Um eine bestimmte Version eines NuGet-Pakets zu installieren, verwenden Sie den optionalen -v- oder --version-Switch:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Verwenden Sie beispielsweise diesen Befehl, um Version 12.0.1 des Newtonsoft.Json-Pakets hinzuzufügen:

dotnet add package Newtonsoft.Json --version 12.0.1

Auflisten von Paketverweisen

Sie können über den Befehl dotnet list package die Paketverweise und -versionen für Ihr Projekt auflisten.

dotnet list package

Entfernen eines Pakets

Verwenden Sie den Befehl dotnet remove package, um einen Paketverweis aus der Projektdatei zu entfernen.

dotnet remove package <PACKAGE_NAME>

Verwenden Sie beispielsweise zum Entfernen des Newtonsoft.Json-Pakets den folgenden Befehl:

dotnet remove package Newtonsoft.Json

Pakete wiederherstellen

Der Dotnet-Wiederherstellungsbefehl stellt Pakete wieder her, die die Projektdatei mit <PackageReference> auflistet. Weitere Informationen finden Sie unter Paketverweis in Projektdateien.

Die Befehle dotnet build und dotnet run in .NET Core 2.0 und höher führen eine automatische Paketwiederherstellung durch. Ab NuGet 4.0 führt dotnet restore denselbe Code aus wie nuget restore.

Wiederherstellen eines Pakets mit dotnet restore:

  1. Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.
  2. Führen Sie dotnet restore aus.

Nächste Schritte