Installieren und Verwalten von Paketen in Visual Studio mithilfe der NuGet-Paket-Manager

Sie können die NuGet-Paket-Manager UI in Microsoft Visual Studio verwenden, um NuGet-Pakete in Projekten und Lösungen einfach zu installieren, zu deinstallieren und zu aktualisieren.

Voraussetzungen

• Visual Studio 2026 mit jeder .NET-bezogenen Arbeitslast. Sie können die 2026 Community Edition kostenlos von visualstudio.microsoft.com installieren, oder Sie können die Professional- oder Enterprise-Edition verwenden.

• Der NuGet-Paketmanager. Visual Studio 2017 und höhere Versionen enthalten automatisch die NuGet-Paket-Manager, wenn eine .NET-bezogene Workload installiert wird. Wenn Sie das NuGet-Paket-Manager manuell in Visual Studio Installer installieren möchten, wählen Sie Individual components>Code tools>NuGet package manager aus.

Suchen und Installieren eines Pakets

Führen Sie die folgenden Schritte aus, um ein NuGet-Paket mithilfe von Visual Studio zu suchen und zu installieren:

1. Laden Sie eine project in Projektmappen-Explorer, und wählen Sie dann Project>Manage NuGet Packages aus.

   Das Fenster NuGet Paket-Manager wird geöffnet.

2. Wechseln Sie zur Registerkarte " Durchsuchen ", um Pakete nach Beliebtheit aus der aktuell ausgewählten Quelle anzuzeigen. Informationen zu Quellen finden Sie unter "Paketquellen".

   • Um nach einem bestimmten Paket zu suchen, verwenden Sie das Suchfeld in der oberen linken Ecke der Registerkarte.
   • Abgekürzte Informationen werden möglicherweise neben jeder Paket-ID angezeigt, damit Sie das richtige Paket identifizieren können. Diese Informationen variieren je nach den ausgewählten Paketquellen. Beispiele sind die Anzahl des Paketdownloads, die Autoren oder ein Link zum Profil des Besitzers.

   Hinweis

   In Visual Studio 17.11 und höher werden Paketbesitzer als Profillinks angezeigt, wenn sie von der ausgewählten Paketquelle unterstützt werden. Der Paketbesitz wird durch die Paketquelle definiert. Weitere Informationen finden Sie unter Verwalten von Paketbesitzern auf nuget.org.

   In Visual Studio 17.10 und früheren Versionen werden die Paket-author-Metadaten angezeigt, die im Klartext erscheinen. Weitere Informationen finden Sie unter Authors-Paketmetadaten.

   • Wählen Sie ein Paket aus, um den Detailbereich zu öffnen. Im Detailbereich werden auf der Registerkarte " Paketdetails " Paketmetadaten, Informationen zu Besitzern, Autoren und Lizenzen sowie weitere Informationen angezeigt. Der Detailbereich bietet ihnen auch die Möglichkeit, eine zu installierende Version auszuwählen.

     

     Auf der Registerkarte README des Detailbereichs wird die Readme-Datei angezeigt, wenn sie vom Paketautor bereitgestellt wird.

     

3. Wählen Sie im Detailbereich neben "Version" eine Version aus. Wenn Sie Vorabversionen in die Liste Version einschließen möchten, wechseln Sie zum Anfang des Fensters NuGet Paket-Manager. Wählen Sie neben dem Suchfeld die Option "Vorabversionen einschließen" aus.

4. Um das NuGet-Paket zu installieren, wählen Sie "Installieren" aus. Möglicherweise werden Sie aufgefordert, Lizenzbedingungen zu akzeptieren oder die Installation zu überprüfen.

   Visual Studio installiert das Paket und dessen Abhängigkeiten im Projekt. Nach Abschluss der Installation werden die hinzugefügten Pakete auf der Registerkarte "NuGet Paket-Manager Installed" angezeigt. Sie finden die Pakete auch im Projektmappen-Explorer unter dem Knoten Dependencies>Packages Ihres Projekts. Nachdem Sie ein Paket installiert haben, können Sie mit einer using Anweisung darauf im Projekt verweisen.

Festlegen des Paketverwaltungsformats

NuGet verfügt über zwei Formate, in denen ein Projekt Pakete verwenden kann:

• PackageReference
• packages.config

Nur einige Arten von Projekten unterstützen beide Paketverwaltungsformate. Insbesondere .NET Framework-Projekte im Nicht-SDK-Stil mit einem .csproj unterstützen beide Formate. Für .NET SDK-Formatprojekte ist PackageReference erforderlich.

Das empfohlene Format ist PackageReference. Einige NuGet-Pakete sind jedoch nicht vollständig kompatibel mit PackageReference. Weitere Informationen finden Sie unter Paketkompatibilitätsprobleme.

Weitere Informationen zu paketverwaltungsformaten finden Sie unter Migrate from packages.config to PackageReference and Project type support.

Führen Sie die folgenden Schritte aus, um das Standardformat festzulegen:

1. Wählen Sie in Visual Studio Tools>Options aus.
2. Wählen Sie im Seitenbereich NuGet Paket-Manager aus, und wählen Sie dann General aus.
3. Wählen Sie im Hauptfenster unter "Paketverwaltung" in der Liste " Standardpaketverwaltungsformat" ein Format aus.

Weitere Informationen zum Konfigurieren dieser Einstellung finden Sie unter Auswählen des Standardpaketverwaltungsformats.

Ein Paket deinstallieren

Führen Sie die folgenden Schritte aus, um ein NuGet-Paket zu deinstallieren:

1. Laden Sie eine project in Projektmappen-Explorer, wählen Sie Project>Manage NuGet Packages aus, und wechseln Sie dann zur Registerkarte Installed.

2. Wählen Sie im Hauptbereich das zu deinstallierende Paket aus. Verwenden Sie bei Bedarf das Suchfeld, um das Paket zu finden. Wählen Sie dann im Bereich "Paketdetails " die Option "Deinstallieren" aus.

   

Aktualisieren eines Pakets

Führen Sie die folgenden Schritte aus, um ein NuGet-Paket zu aktualisieren:

1. Laden Sie eine project in Projektmappen-Explorer, und wählen Sie dann Project>Manage NuGet Packages aus. Wechseln Sie für ältere ASP.NET-Websiteprojekte, die Abhängigkeiten über den Ordner bin verwalten, zu Projektmappen-Explorer und wählen Sie den Ordner bin aus, bevor Sie die NuGet-Paket-Manager-Benutzeroberfläche öffnen.

2. Wählen Sie die Registerkarte "Updates " aus, um Pakete mit verfügbaren Updates aus der Quelle anzuzeigen, die neben der Paketquelle ausgewählt ist. Um Vorabversionen von Paketen in die Updateliste einzuschließen, wechseln Sie zum Anfang des Fensters NuGet Paket-Manager. Wählen Sie neben dem Suchfeld die Option "Vorabversionen einschließen" aus.

3. Wählen Sie das zu aktualisierende Paket aus. Wählen Sie im Detailbereich neben "Version" die gewünschte Version und dann "Aktualisieren" aus.

   

Aktualisieren eines implizit referenzierten Pakets

Bei einigen Paketen ist die Schaltfläche " Aktualisieren " nicht verfügbar, und die folgende Meldung wird angezeigt: "Implizit wird von einem SDK referenziert. Um das Paket zu aktualisieren, aktualisieren Sie das SDK, zu dem es gehört."

Diese Meldung gibt an, dass das Paket Teil eines größeren Frameworks oder SDK ist und nicht unabhängig aktualisiert werden kann. Beispielsweise wird Microsoft.NETFramework.ReferenceAssemblies automatisch hinzugefügt, wenn ein SDK-Projekt auf .NET Framework ausgerichtet ist.

Solche Pakete werden intern mit <IsImplicitlyDefined>True</IsImplicitlyDefined>. Diese Pakete sind mit dem SDK oder der Laufzeit versioniert und müssen aktualisiert werden, indem ein neueres .NET SDK installiert wird, nicht mithilfe von NuGet-Paket-Manager.

Informationen zum Herunterladen einer neuen Version eines Frameworks finden Sie unter Download .NET. Weitere Informationen finden Sie unter .NET Anwendungsveröffentlichungsübersicht.

Aktualisieren mehrerer Pakete

Wenn Sie mehrere Pakete auf ihre neuesten Versionen aktualisieren möchten, wählen Sie sie in der NuGet-Paketliste aus, und wählen Sie dann "Aktualisieren" aus.

Aktualisieren über die Registerkarte "Installiert"

Sie können ein einzelnes Paket auch über die Registerkarte "Installiert " aktualisieren. In diesem Fall können Sie auch eine Version und die Option "Vorabversion einschließen " auswählen.

Verwalten von Paketen für die Lösung

Das Verwalten von Paketen für eine Lösung ist eine bequeme Möglichkeit, gleichzeitig mit mehreren Projekten zu arbeiten.

1. Wählen Sie eine Lösung in Solution Manager aus, und wählen Sie dann Tools>NuGet Paket-Manager>Manage NuGet Packages for Solution aus.

2. Wählen Sie im Fenster "Pakete für Lösung verwalten" die Projekte aus, für die ein Vorgang angewendet werden soll.

   

Registerkarte "Konsolidieren"

Entwickler betrachten es in der Regel als schlechte Methode, unterschiedliche Versionen desselben NuGet-Pakets in verschiedenen Projekten in derselben Lösung zu verwenden. Sie können das Fenster " Pakete für Lösung verwalten " verwenden, um eine allgemeine Version für Ihre NuGet-Pakete zu verwenden. Wechseln Sie dazu zur Registerkarte " Konsolidieren ", um zu ermitteln, wo Pakete mit unterschiedlichen Versionsnummern von verschiedenen Projekten in der Lösung verwendet werden.

In diesem Beispiel verwendet EntityFramework das MyClassLibrary-Projekt 6.5.1, aber MyConsoleApp verwendet EntityFramework 6.5.0. Führen Sie die folgenden Schritte aus, um Paketversionen zu konsolidieren:

1. Wählen Sie auf der Registerkarte " Konsolidieren " die Projekte aus, die in der Projektliste aktualisiert werden sollen.

2. Wählen Sie neben "Version" die Version aus, die für alle ausgewählten Projekte verwendet werden soll.

3. Wählen Sie Installieren aus.

   Die NuGet-Paket-Manager installiert die ausgewählte Paketversion in allen ausgewählten Projekten, und das Paket wird nicht mehr auf der Registerkarte Consolidate angezeigt.

Paketquellen

Visual Studio ignoriert die Reihenfolge der Paketquellen. Stattdessen wird das Paket aus der Quelle verwendet, das zuerst auf eine Anforderung antwortet. Weitere Informationen finden Sie unter "Wiederherstellen von Paketen". Informationen zum Laden eines Pakets aus einer bestimmten Quelle finden Sie unter Paketquellzuordnung.

1. Wenn Sie die Quelle ändern möchten, aus der Visual Studio Paketmetadaten lädt, wechseln Sie oben im Fenster NuGet Paket-Manager oder im Fenster Pakete für die Lösung verwalten. Wählen Sie neben der Paketquelle die Quelle aus, die Sie verwenden möchten.

   

2. Um Ihre Paketquellen zu verwalten, wählen Sie das Symbol Einstellungen aus, oder wählen Sie Extras>Optionen aus.

   

3. Informationen zum Verwalten von NuGet-Paketquellen finden Sie unter NuGet Paket-Manager Optionen in Visual Studio.

NuGet Paket-Manager Options-Steuerung

Wenn Sie ein Paket auswählen, zeigt das NuGet-Paket-Manager ein erweiterbares Options-Steuerelement im Detailbereich unterhalb der Liste Version an. Für die meisten Projekttypen wird nur das Kontrollkästchen "Vorschaufenster anzeigen" bereitgestellt. Für einige Projekttypen stehen aber auch andere Optionen zur Verfügung.

In den folgenden Abschnitten werden die verfügbaren Optionen erläutert.

Installations- und Updateoptionen

Diese Optionen sind nur für bestimmte Projekttypen verfügbar:

• Abhängigkeitsverhalten: Diese Option gibt die Versionen abhängiger Pakete an, die NuGet installiert. Sie verfügt über die folgenden Einstellungen:

  • Abhängigkeiten ignorieren überspringt die Installation von Abhängigkeiten, wodurch das Paket normalerweise unterbrochen wird.
  • Niedrigste installiert die Abhängigkeit mit der minimalen Versionsnummer, die die Anforderungen des primär ausgewählten Pakets erfüllt. Diese Einstellung ist die Standardeinstellung.
  • Der höchste Patch installiert die Version mit den gleichen Haupt- und Nebenversionsnummern wie die ausgewählte Version, aber die höchste Patchnummer. Wenn beispielsweise Version 1.2.2 angegeben ist, wird die höchste Version, die mit 1.2 beginnt, installiert.
  • Mit der höchsten Nebenversion wird die Version mit derselben Hauptversionsnummer, aber mit der höchsten Nebenversionnummer und Patchnummer der ausgewählten Version installiert. Wenn Version 1.2.2 angegeben ist, wird die höchste Version, die mit 1 beginnt, installiert.
  • Die höchste verfügbare Version des Pakets wird installiert.

• Dateikonfliktaktion: Diese Option gibt an, wie NuGet Pakete verarbeitet, die bereits im Projekt oder auf dem lokalen Computer vorhanden sind. Sie verfügt über die folgenden Einstellungen:

  • Die Aufforderung weist NuGet an, zu fragen, ob vorhandene Pakete beibehalten oder überschrieben werden sollen.
  • "Alle ignorieren" weist NuGet an, das Überschreiben vorhandener Pakete zu überspringen.
  • Alle überschreiben weist NuGet an, alle vorhandenen Pakete zu überschreiben.

Deinstallationsoptionen

Diese Optionen sind nur für bestimmte Projekttypen verfügbar:

• Entfernen von Abhängigkeiten: Wenn diese Option ausgewählt ist, werden alle abhängigen Pakete entfernt, wenn sie nicht an anderer Stelle im Projekt referenziert werden.

• Deinstallation erzwingen, auch wenn es Abhängigkeiten gibt: Wenn diese Option ausgewählt ist, deinstalliert diese Option ein Paket, auch wenn im Projekt noch darauf verwiesen wird. Diese Option wird in der Regel in Kombination mit "Abhängigkeiten entfernen" verwendet, um ein Paket und die installierten Abhängigkeiten zu entfernen. Die Verwendung dieser Option kann jedoch zu fehlerhaften Verweisen im Projekt führen. In diesem Fall müssen Sie diese anderen Pakete möglicherweise erneut installieren.

Verwandte Videos

• Videos zur Verwendung von NuGet für die Paketverwaltung finden Sie unter Channel 9 und YouTube.

Verwandte Inhalte

Weitere Informationen zu NuGet finden Sie in den folgenden Artikeln:

• Eine Einführung in NuGet
• Paketverbrauchsworkflow
• Suchen und Bewerten von NuGet-Paketen für Ihr Projekt
• PackageReference in Projektdateien
• Schnellstart: Installieren und Verwenden eines Pakets mit der dotnet CLI