Freigeben über

Installieren und Verwalten von NuGet-Paketen mit der dotnet CLI

Sie können das Befehlszeilenschnittstellentool (Dotnet Command-Line Interface, CLI) auf Windows, macOS oder Linux verwenden, um NuGet-Pakete in .NET Projekten und Lösungen einfach 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 Projekte im SDK-Stil, die auf .NET Framework abzielen. Weitere Informationen finden Sie unter .NET-Projekt-SDKs.

Für die meisten Befehle sucht das CLI-Tool im aktuellen Verzeichnis nach einer Projektdatei, es sei denn, eine andere Projektdatei wird als optionaler Schalter im Befehl angegeben. Eine vollständige Liste der Befehle und deren Argumente finden Sie unter dotnet CLI-Befehle.

Voraussetzungen

Das .NET SDK, das die dotnet CLI bereitstellt. In Visual Studio wird die dotnet CLI automatisch mit allen .NET-bezogenen Workloads installiert.

Installieren oder Aktualisieren eines Pakets

Der dotnet package add Befehl fügt der Projektdatei einen Paketverweis hinzu und führt danach dotnet restore aus, um das Paket zu installieren.

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

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

    dotnet package add <package-name>

    Verwenden Sie z. B. den folgenden Befehl, um das Newtonsoft.Json Paket zu installieren:

    dotnet package add Newtonsoft.Json

    Wenn Sie .NET 9 oder früher verwenden, nutzen Sie stattdessen die Verb-zuerst-Form des Befehls.

    dotnet add package <package-name>

  3. Öffnen Sie nach Abschluss des Befehls die Projektdatei, um nach dem Paketverweis zu suchen.

    Öffnen Sie beispielsweise die CSPROJ-Datei , und suchen Sie nach der hinzugefügten Newtonsoft.Json Paketreferenz:

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

Installieren einer bestimmten Paketversion

Der dotnet package add Befehl installiert die neueste Version des Pakets, es sei denn, Sie geben eine andere Version an.

Um eine bestimmte Version eines NuGet-Pakets zu installieren, verwenden Sie optional die Option -v oder --version.

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

Verwenden Sie z. B. den folgenden Befehl, um Version 13.0.1 des Newtonsoft.Json Pakets hinzuzufügen:

dotnet package add Newtonsoft.Json --version 13.0.1

Liste der Paketreferenzen

Sie können den Dotnet-Paketlistenbefehl verwenden, um die Paketverweise und -versionen für Ihr Projekt auflisten. Führen Sie im Verzeichnis, das Ihre Projektdatei enthält, den folgenden Befehl aus:

dotnet package list

Wenn Sie .NET 9 oder früher verwenden, nutzen Sie stattdessen die verb-first-Form.

dotnet list package

Entfernen eines Pakets

Sie können den Befehl zum Entfernen des dotnet-Pakets verwenden, um einen Paketverweis aus der Projektdatei zu entfernen. Führen Sie im Verzeichnis, das Ihre Projektdatei enthält, den folgenden Befehl aus:

dotnet package remove <package-name>

Verwenden Sie beispielsweise den folgenden Befehl, um das Newtonsoft.Json Paket zu entfernen:

dotnet package remove Newtonsoft.Json

Wenn Sie .NET 9 oder früher verwenden, nutzen Sie stattdessen die verb-first-Form.

dotnet remove package <package-name>

Pakete wiederherstellen

Mit dem dotnet restore Befehl werden Pakete wiederhergestellt, die in <PackageReference> Elementen in der Projektdatei aufgeführt sind. Weitere Informationen finden Sie in den PackageReferenceProjektdateien.

Beginnend mit .NET Core 2.0 und fortlaufend bei .NET werden von den Befehlen dotnet build und dotnet run Pakete automatisch wiederhergestellt, genauso wie von vielen anderen dotnet CLI-Befehlen. Ab NuGet 4.0 dotnet restore wird der gleiche Code wie der nuget restore NuGet CLI-Befehl ausgeführt.

So stellen Sie die Pakete mithilfe von dotnet restore wieder her:

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

Verwandte Inhalte

  • Last updated on