Instalace a správa balíčků v Visual Studio pomocí Package Manager NuGet

Pomocí uživatelského rozhraní NuGet Package Manager v Microsoft Visual Studio můžete snadno instalovat, odinstalovat a aktualizovat balíčky NuGet v projektech a řešeních.

Požadavky

Visual Studio 2026 se všemi úlohami souvisejícími s .NET. Edici 2026 Community si můžete nainstalovat zdarma z visualstudio.microsoft.com nebo můžete použít edici Professional nebo Enterprise.
NuGet Správce balíčků. Visual Studio 2017 a novějších verzích automaticky zahrnují Package Manager NuGet při instalaci úlohy související s .NET. Pokud chcete Package Manager NuGet nainstalovat ručně v instalačním programu Visual Studio, vyberte Individual components>Code tools>NuGet package manager.

Vyhledání a instalace balíčku

Pokud chcete vyhledat a nainstalovat balíček NuGet pomocí Visual Studio, postupujte takto:

Načtěte projekt v Solution Explorer a pak vyberte Projekt>Spravovat balíčky NuGet.

Otevře se okno NuGet Package Manager.
Přejděte na kartu Procházet a zobrazte balíčky podle oblíbenosti z aktuálně vybraného zdroje. Informace o zdrojích najdete v tématu Zdroje balíčků.
- Chcete-li vyhledat konkrétní balíček, použijte vyhledávací pole v levém horním rohu karty.
- Vedle každého ID balíčku se můžou zobrazit zkrácené informace, které vám pomůžou identifikovat správný balíček. Tyto informace se liší v závislosti na vybraných zdrojích balíčků. Mezi příklady patří počet stažení balíčku, autoři nebo odkaz na profil vlastníka.
Poznámka:

V Visual Studio 17.11 a novějších se vlastníci balíčků zobrazují jako odkazy na profily, pokud je podporuje vybraný zdroj balíčku. Vlastnictví balíčku je definováno zdrojem balíčku. Další informace najdete v tématu Správa vlastníků balíčků na nuget.org.

V Visual Studio 17.10 a starších se zobrazí metadata balíčku author, která se zobrazí jako prostý text. Další informace najdete v tématu Metadata balíčku autorů.
- Výběrem balíčku otevřete podokno podrobností. V podokně podrobností se na kartě Podrobnosti balíčku zobrazí metadata balíčku, informace o vlastnících, autorech a licenci a další informace. Podokno podrobností také nabízí způsob, jak vybrat verzi, kterou chcete nainstalovat.
  
  Karta README v podokně podrobností zobrazí soubor read-me balíčku, pokud ho poskytl autor balíčku.
V podokně podrobností vedle položky Verze vyberte verzi. Pokud chcete zahrnout předběžné verze do seznamu Version, přejděte na začátek okna NuGet Package Manager. Vedle vyhledávacího pole vyberte Zahrnout předběžné verze.
Chcete-li nainstalovat balíček NuGet, vyberte Nainstalovat. Může se zobrazit výzva k přijetí licenčních podmínek nebo ověření instalace.

Visual Studio nainstaluje balíček a jeho závislosti v projektu. Po dokončení instalace se přidané balíčky zobrazí na kartě NuGet Package Manager Installed. Balíčky najdete také v Solution Explorer v uzlu Dependencies>Packages uzlu projektu. Po instalaci balíčku na něj můžete odkazovat v projektu pomocí using příkazu.

Nastavení formátu správy balíčků

NuGet má dva formáty, ve kterých může projekt používat balíčky:

Oba formáty správy balíčků podporují pouze některé typy projektů. Konkrétně projekty .NET Framework bez sady SDK, které mají .csproj podporují oba formáty. Pro projekty ve stylu sady SDK .NET se vyžaduje PackageReference.

Doporučený formát je PackageReference. Některé balíčky NuGet ale nejsou plně kompatibilní s PackageReference. Další informace najdete v tématu Problémy s kompatibilitou balíčků.

Další informace o formátech správy balíčků najdete v tématu Migrace z packages.config do PackageReference a Podpora typů projektů.

Chcete-li nastavit výchozí formát, postupujte takto:

V Visual Studio vyberte Tools>Options.
V bočním podokně vyberte NuGet Package Manager a pak vyberte General.
V hlavním okně v části Správa balíčků vyberte formát v seznamu Výchozí formát správy balíčků .

Další informace o konfiguraci tohoto nastavení najdete v tématu Volba výchozího formátu správy balíčků.

Odinstalujte balíček

Chcete-li odinstalovat balíček NuGet, postupujte takto:

Načtěte projekt v Solution Explorer, vyberte Projekt>Spravovat balíčky NuGet a pak přejděte na kartu Nainstalováno.
V hlavním podokně vyberte balíček, který chcete odinstalovat. V případě potřeby vyhledejte balíček pomocí vyhledávacího pole. Potom v podokně podrobností balíčku vyberte Odinstalovat.

Aktualizace balíčku

Chcete-li aktualizovat balíček NuGet, postupujte takto:

Načtěte projekt v Solution Explorer a pak vyberte Projekt>Spravovat balíčky NuGet. U starších projektů ASP.NET webů, které spravují závislosti prostřednictvím složky bin, přejděte na Solution Explorer a vyberte složku bin před otevřením uživatelského rozhraní Package Manager NuGet.
Vyberte kartu Aktualizace a zobrazte seznam balíčků, které mají dostupné aktualizace ze zdroje vybraného vedle zdroje balíčku. Pokud chcete do seznamu aktualizací zahrnout předběžné balíčky, přejděte na začátek okna NuGet Package Manager. Vedle vyhledávacího pole vyberte Zahrnout předběžné verze.
Vyberte balíček, který chcete aktualizovat. V podokně podrobností vedle položky Verze vyberte požadovanou verzi a pak vyberte Aktualizovat.

Aktualizace implicitně odkazovaného balíčku

U některých balíčků není tlačítko Aktualizovat k dispozici a zobrazí se následující zpráva: Implicitně odkazované sadou SDK. Pokud chcete balíček aktualizovat, aktualizujte sadu SDK, do které patří."

Tato zpráva označuje, že balíček je součástí větší architektury nebo sady SDK a nelze jej aktualizovat nezávisle. Například Microsoft.NETFramework.ReferenceAssemblies se automaticky přidá, když projekt ve stylu sady SDK cílí na .NET Framework.

Tyto balíčky jsou interně označeny <IsImplicitlyDefined>True</IsImplicitlyDefined>. Tyto balíčky jsou verzí sady SDK nebo modulu runtime a musí být aktualizovány instalací novější sady .NET SDK, nikoli pomocí Package Manager NuGet.

Pokud chcete stáhnout novou verzi rámce, viz Download .NET. Další informace najdete v přehledu publikování aplikací .NET.

Aktualizace více balíčků

Pokud chcete aktualizovat více balíčků na nejnovější verze, vyberte je v seznamu balíčků NuGet a pak vyberte Aktualizovat.

Aktualizace ze záložky Nainstalované

Jednotlivé balíčky můžete aktualizovat také na kartě Nainstalované . V tomto případě můžete také vybrat verzi a možnost Zahrnout předběžné verze .

Správa balíčků pro řešení

Správa balíčků pro řešení je pohodlný způsob, jak pracovat s více projekty současně.

V Solution Manager vyberte řešení. a pak vyberte Tools>NuGet Package Manager>Manage NuGet packages for Solution.
V okně Spravovat balíčky pro řešení vyberte projekty, na které se má operace použít.

Karta Konsolidace

Vývojáři obvykle považují za špatný postup použití různých verzí stejného balíčku NuGet v různých projektech ve stejném řešení. V okně Spravovat balíčky pro řešení můžete použít společnou verzi balíčků NuGet. Uděláte to tak, že přejdete na kartu Konsolidovat a zjistíte, kde balíčky s odlišnými čísly verzí používají různé projekty v řešení.

V tomto příkladu projekt MyClassLibrary používá EntityFramework verzi 6.5.1, ale MyConsoleApp používá EntityFramework verzi 6.5.0. Chcete-li konsolidovat verze balíčků, postupujte takto:

Na kartě Konsolidovat vyberte projekty, které se mají aktualizovat v seznamu projektů.
Vedle položky Verze vyberte verzi, která se má použít pro všechny vybrané projekty.
Vyberte volbu Instalovat.

NuGet Package Manager nainstaluje vybranou verzi balíčku do všech vybraných projektů a balíček se už nezobrazí na kartě Consolidate.

Zdroje balíčků

Visual Studio ignoruje pořadí zdrojů balíčků. Místo toho používá balíček ze zdroje, který nejprve odpoví na požadavek. Další informace naleznete v tématu Obnovení balíčků. Informace o tom, jak načíst balíček z konkrétního zdroje, naleznete v tématu Mapování zdroje balíčků.

Pokud chcete změnit zdroj, ze kterého Visual Studio načítá metadata balíčku, přejděte na začátek okna NuGet Package Manager nebo do okna Manage Packages for Solution. Vedle zdroje balíčku vyberte zdroj, který chcete použít.
Pokud chcete spravovat zdroje balíčků, vyberte ikonu Nastavení nebo vyberte Možnosti nástrojů>.
Informace o správě zdrojů balíčků NuGet najdete v tématu Možnosti Package Manager NuGet v Visual Studio.

Možnosti ovládání NuGet Package Manager

Když vyberete balíček, Package Manager NuGet zobrazí rozbalitelný ovládací prvek Options v podokně podrobností pod seznamem Version. U většiny typů projektů je k dispozici pouze zaškrtávací políčko Zobrazit okno náhledu . U některých typů projektů jsou ale k dispozici i další možnosti.

V následujících částech jsou vysvětleny dostupné možnosti.

Možnosti instalace a aktualizace

Tyto možnosti jsou k dispozici pouze pro některé typy projektů:

Chování závislostí: Tato možnost určuje verze závislých balíčků, které NuGet nainstaluje. Má následující nastavení:
- Přeskočení závislostí přeskočí instalaci závislostí, což obvykle přeruší instalaci balíčku, který se instaluje.
- Nejnižší nainstaluje závislost s minimálním číslem verze, které splňuje požadavky primárního vybraného balíčku. Toto nastavení je výchozí.
- Nejvyšší opravný balíček nainstaluje verzi se stejným hlavním a podverzním číslem jako vybraná verze, ale s nejvyšším číslem opravného balíčku. Pokud je například zadána verze 1.2.2, nainstaluje se nejvyšší verze, která začíná verzí 1.2.
- Nejvyšší menší verze nainstaluje verzi se stejným číslem hlavní verze jako vybraná verze, ale s nejvyšším číslem menší verze a čísla opravy. Pokud je zadána verze 1.2.2, nainstaluje se nejvyšší verze, která začíná na 1.
- Nejvyšší nainstaluje nejvyšší dostupnou verzi balíčku.
Akce konfliktu souboru: Tato možnost určuje, jak NuGet zpracovává balíčky, které již existují v projektu nebo místním počítači. Má následující nastavení:
- Výzva vyzve NuGet k zadání dotazu, jestli chcete zachovat nebo přepsat existující balíčky.
- Ignorovat všechny dává NuGet pokyn, aby přeskočil přepsání jakéhokoli existujícího balíčku.
- Přepsat vše dává NuGet pokyn, aby přepsal všechny existující balíčky.

Možnosti odinstalace