Instalowanie pakietów i zarządzanie nimi w Visual Studio przy użyciu Package Manager NuGet

Interfejs użytkownika Package Manager NuGet można użyć w Microsoft Visual Studio, aby łatwo instalować, odinstalować i aktualizować pakiety NuGet w projektach i rozwiązaniach.

Wymagania wstępne

  • Visual Studio 2026 z dowolnym zadaniem związanym z .NET. Możesz bezpłatnie zainstalować wersję Community Edition 2026 z visualstudio.microsoft.com lub użyć wersji Professional lub Enterprise.

  • Menedżer pakietów NuGet. Visual Studio 2017 i nowsze wersje automatycznie dołączają Menedżer pakietów NuGet po zainstalowaniu zestawu narzędzi powiązanych z .NET. Aby ręcznie zainstalować Package Manager NuGet w instalatorze Visual Studio, wybierz pozycję Individual components>Code tools>NuGet package manager.

Znajdowanie i instalowanie pakietu

Aby znaleźć i zainstalować pakiet NuGet przy użyciu Visual Studio, wykonaj następujące kroki:

  1. Załaduj project w Solution Explorer, a następnie wybierz Project>Zarządzanie pakietami NuGet.

    Zostanie otwarte okno NuGet Package Manager.

  2. Przejdź do karty Przeglądaj , aby wyświetlić pakiety według popularności z aktualnie wybranego źródła. Aby uzyskać informacje o źródłach, zobacz Źródła pakietów.

    • Aby wyszukać określony pakiet, użyj pola wyszukiwania w lewym górnym rogu zakładki.
    • Skrócone informacje mogą być wyświetlane obok każdego identyfikatora pakietu, aby ułatwić identyfikację poprawnego pakietu. Te informacje różnią się w zależności od wybranych źródeł pakietów. Przykłady obejmują liczbę pobierania pakietu, autorów lub link do profilu właściciela.

    Uwaga / Notatka

    W Visual Studio 17.11 i nowszych właściciele pakietów są wyświetlani w formie linków do profilu, o ile jest to obsługiwane przez wybrane źródło pakietu. Własność pakietu jest definiowana przez źródło pakietu. Aby uzyskać więcej informacji, zobacz Zarządzanie właścicielami pakietów w nuget.org.

    W Visual Studio 17.10 i starszych jest wyświetlany pakiet author metadanych, który jest wyświetlany jako zwykły tekst. Aby uzyskać więcej informacji, zobacz Metadane pakietu autorów.

    • Wybierz pakiet, aby otworzyć okienko szczegółów. W okienku szczegółów karta Szczegóły pakietu zawiera metadane pakietu, informacje o właścicielach, autorach i licencjach oraz innych informacjach. Okienko szczegółów umożliwia również wybranie wersji do zainstalowania.

      Zrzut ekranu Menadżera pakietów NuGet. Na karcie Przeglądaj wybrano pakiet. Zakładka Szczegóły pakietu w panelu szczegółów wyświetla dane pakietu.

      Na karcie README panelu szczegółów wyświetlany jest plik README pakietu, jeśli jest on dostarczany przez autora pakietu.

      Zrzut ekranu Menedżera Pakietów NuGet. Na karcie Przeglądanie wybrano pakiet. Karta README w okienku szczegółów zawiera opis pakietu.

  3. W okienku szczegółów obok pozycji Wersja wybierz wersję. Jeśli chcesz uwzględnić wersje wstępne na liście Version, przejdź na górę okna NuGet Package Manager. Obok pola wyszukiwania wybierz pozycję Uwzględnij wersję wstępną.

  4. Aby zainstalować pakiet NuGet, wybierz pozycję Zainstaluj. Może zostać wyświetlony monit o zaakceptowanie postanowień licencyjnych lub zweryfikowanie instalacji.

    Visual Studio instaluje pakiet i jego zależności w projekcie. Po zakończeniu instalacji dodane pakiety są wyświetlane na karcie NuGet Package Manager Installed. Pakiety można również znaleźć w Solution Explorer w węźle Dependencies>Packages węźle projektu. Po zainstalowaniu pakietu można odwoływać się do niego w projekcie za pomocą instrukcji using .

Ustawianie formatu zarządzania pakietami

NuGet ma dwa formaty, w których projekt może używać pakietów:

Tylko niektóre typy projektów obsługują oba formaty zarządzania pakietami. W szczególności projekty .NET Framework bez stylu SDK, które mają plik .csproj, obsługują oba formaty. W przypadku projektów .NET w stylu zestawu SDK wymagane jest PackageReference.

Zalecanym formatem jest PackageReference. Jednak niektóre pakiety NuGet nie są w pełni zgodne z .PackageReference Aby uzyskać więcej informacji, zobacz Problemy ze zgodnością pakietów.

Aby uzyskać więcej informacji na temat formatów zarządzania pakietami, zobacz Migrate from packages.config to PackageReference oraz Project type support.

Aby ustawić format domyślny, wykonaj następujące kroki:

  1. W Visual Studio wybierz pozycję Tools>Options.
  2. W okienku bocznym wybierz pozycję NuGet Package Manager a następnie wybierz pozycję Ogólne.
  3. W oknie głównym w obszarze Zarządzanie pakietami wybierz format na liście Domyślny format zarządzania pakietami .

Aby uzyskać więcej informacji na temat konfigurowania tego ustawienia, zobacz Wybieranie domyślnego formatu zarządzania pakietami.

Odinstalowywanie pakietu

Aby odinstalować pakiet NuGet, wykonaj następujące kroki:

  1. Załaduj project w Solution Explorer wybierz Project>Zarządzanie pakietami NuGet, a następnie przejdź do karty Installed.

  2. W okienku głównym wybierz pakiet do odinstalowania. W razie potrzeby użyj pola wyszukiwania, aby znaleźć pakiet. Następnie w okienku szczegółów pakietu wybierz pozycję Odinstaluj.

    Zrzut ekranu menadżera pakietów NuGet. W głównym okienku wybrano pakiet. W okienku szczegółów przycisk Odinstaluj jest wyróżniony.

Aktualizowanie pakietu

Aby zaktualizować pakiet NuGet, wykonaj następujące kroki:

  1. Załaduj project w Solution Explorer, a następnie wybierz Project>Zarządzanie pakietami NuGet. W przypadku starszych projektów Web Site ASP.NET, które zarządzają zależnościami za pośrednictwem folderu bin, przejdź do Eksploratora rozwiązań i wybierz folder bin przed otwarciem interfejsu użytkownika Menedżera pakietów NuGet.

  2. Wybierz kartę Aktualizacje , aby wyświetlić listę pakietów, które mają dostępne aktualizacje ze źródła wybranego obok pozycji Źródło pakietu. Aby uwzględnić pakiety wersji wstępnej na liście aktualizacji, przejdź do góry okna NuGet Package Manager. Obok pola wyszukiwania wybierz pozycję Uwzględnij wersję wstępną.

  3. Wybierz pakiet do zaktualizowania. W okienku szczegółów obok pozycji Wersja wybierz żądaną wersję, a następnie wybierz pozycję Aktualizuj.

    Zrzut ekranu Menedżera pakietów NuGet. W okienku głównym wybrano pakiet. W okienku szczegółów wyróżniono wersję i przycisk Aktualizuj.

Aktualizowanie niejawnie przywoływnego pakietu

W przypadku niektórych pakietów przycisk Aktualizuj nie jest dostępny, a wyświetlany jest następujący komunikat: "Niejawnie przywoływany przez pakiet SDK. Aby zaktualizować pakiet, zaktualizuj zestaw SDK, do którego należy".

Ten komunikat wskazuje, że pakiet jest częścią większej struktury lub zestawu SDK i nie można go aktualizować niezależnie. Na przykład Microsoft.NETFramework.ReferenceAssemblies jest automatycznie dodawany, gdy projekt w stylu SDK jest ukierunkowany na .NET Framework.

Oekran okienka szczegółów pakietu w Package Manager NuGet. Przycisk Aktualizuj jest wyświetlany jako wygaszony. Komunikat o niejawnym odwołaniu jest widoczny.

Takie pakiety są wewnętrznie oznaczone znakiem <IsImplicitlyDefined>True</IsImplicitlyDefined>. Te pakiety są wersjonowane przy użyciu zestawu SDK lub środowiska uruchomieniowego i muszą zostać zaktualizowane przez zainstalowanie nowszego zestawu .NET SDK, a nie przy użyciu Package Manager NuGet.

Aby pobrać nową wersję platformy, zobacz Pobierz .NET. Aby uzyskać więcej informacji, zobacz .NET omówienie publikowania aplikacji.

Aktualizowanie wielu pakietów

Aby zaktualizować wiele pakietów do najnowszych wersji, wybierz je na liście pakietów NuGet, a następnie wybierz pozycję Aktualizuj.

Aktualizacja z zakładki Zainstalowane

Możesz również zaktualizować pojedynczy pakiet na karcie Zainstalowane . W tym przypadku możesz również wybrać wersję i opcję Uwzględnij wersję wstępną .

Zarządzanie pakietami dla rozwiązania

Zarządzanie pakietami dla rozwiązania jest wygodnym sposobem pracy z wieloma projektami jednocześnie.

  1. Wybierz rozwiązanie w Solution Manager, a następnie wybierz Tools>NuGet Package Manager>Zarządzanie pakietami NuGet dla rozwiązania.

  2. W oknie Zarządzanie pakietami dla rozwiązania wybierz projekty, do których ma być zastosowana operacja.

    Zrzut ekranu przedstawiający okno Zarządzanie pakietami dla rozwiązania. W okienku szczegółów pakietu są zaznaczone wszystkie projekty, a przycisk Zainstaluj jest dostępny.

Karta Konsolidacja

Programiści zazwyczaj uważają, że złą praktyką jest używanie różnych wersji tego samego pakietu NuGet w różnych projektach w ramach tego samego rozwiązania. W oknie Zarządzanie pakietami dla rozwiązania można użyć wspólnej wersji pakietów NuGet. W tym celu przejdź do karty Konsolidowanie , aby dowiedzieć się, gdzie pakiety z unikatowymi numerami wersji są używane przez różne projekty w rozwiązaniu.

Zrzut ekranu przedstawiający okno Zarządzanie pakietami dla rozwiązania. Okienko szczegółów pakietu zawiera listę dwóch projektów korzystających z różnych wersji pakietu.

W tym przykładzie projekt MyClassLibrary używa EntityFramework wersji 6.5.1, ale aplikacja MyConsoleApp używa EntityFramework wersji 6.5.0. Aby skonsolidować wersje pakietów, wykonaj następujące kroki:

  1. Na karcie Konsolidowanie wybierz projekty do zaktualizowania na liście projektów.

  2. Obok pozycji Wersja wybierz wersję do użycia dla wszystkich wybranych projektów.

  3. Wybierz Zainstaluj.

    Package Manager NuGet instaluje wybraną wersję pakietu we wszystkich wybranych projektach, a pakiet nie jest już wyświetlany na karcie Consolidate.

Źródła pakietów

Visual Studio ignoruje kolejność źródeł pakietów. Zamiast tego używa pakietu ze źródła, który najpierw odpowiada na żądanie. Aby uzyskać więcej informacji, zobacz Przywracanie pakietów. Aby uzyskać informacje na temat ładowania pakietu z określonego źródła, zobacz Mapowanie źródła pakietów.

  1. Aby zmienić źródło, z którego Visual Studio ładuje metadane pakietu, przejdź do góry okna NuGet Package Manager lub okna Manage Packages for Solution. Obok pozycji Źródło pakietu wybierz źródło, którego chcesz użyć.

    Zrzut ekranu przedstawiający prawy górny róg okna Zarządzanie pakietami dla rozwiązania. Lista źródłowa pakietu jest wyróżniona, a nuget.org jest zaznaczona.

  2. Aby zarządzać źródłami pakietów, wybierz ikonę Ustawienia lub wybierz pozycję Opcje narzędzi>.

    Zrzut ekranu przedstawiający prawy górny róg okna Zarządzania pakietami dla rozwiązania. Obok listy źródeł pakietu wyróżniono ikonę ustawień.

  3. Aby zarządzać źródłami pakietów NuGet, zobacz opcje NuGet Package Manager w Visual Studio.

Kontrolka Opcje Package Manager NuGet

Po wybraniu pakietu Menedżer pakietów NuGet wyświetla kontrolkę Opcji w okienku szczegółów poniżej listy Wersja. W przypadku większości typów projektów jest dostępne tylko pole wyboru Pokaż okno podglądu . Jednak w przypadku niektórych typów projektów dostępne są również inne opcje.

Zrzut ekranu przedstawiający kontrolkę Opcje w okienku szczegółów pakietu w Package Manager NuGet z opcjami instalowania, aktualizowania i odinstalowywania.

W poniższych sekcjach opisano dostępne opcje.

Opcje instalacji i aktualizacji

Te opcje są dostępne tylko dla niektórych typów projektów:

  • Zachowanie zależności: ta opcja określa wersje pakietów zależnych, które instalowane są przez NuGet. Ma następujące ustawienia:

    • Ignoruj zależności pomija instalację zależności, co zwykle przerywa instalowanie pakietu.
    • Najniższa instalacja zależności z minimalnym numerem wersji spełniającym wymagania wybranego pakietu podstawowego. To ustawienie jest domyślne.
    • Najwyższa poprawka instaluje wersję z tymi samymi numerami wersji głównej i pomocniczej co wybrana wersja, ale najwyższy numer poprawki. Jeśli na przykład zostanie określona wersja 1.2.2, zostanie zainstalowana najwyższa wersja rozpoczynająca się od wersji 1.2.
    • Najwyższa wersja podrzędna instaluje wersję z takim samym numerem głównym jak wybrana wersja, ale z najwyższą liczbą podrzędną i numerem poprawki. Jeśli zostanie określona wersja 1.2.2, zostanie zainstalowana najwyższa wersja rozpoczynająca się od 1.
    • Najwyższa instaluje najwyższą dostępną wersję pakietu.

  • Akcja powodująca konflikt plików: ta opcja określa sposób obsługi pakietów NuGet, które już istnieją w projekcie lub komputerze lokalnym. Ma następujące ustawienia:

    • Monit instruuje NuGet, aby zapytał, czy zachować czy nadpisać istniejące pakiety.
    • Ignoruj wszystkie instruuje NuGet, aby pominąć zastępowanie jakichkolwiek istniejących pakietów.
    • Zastąp wszystkie powoduje, że pakiet NuGet zastąpi wszystkie istniejące pakiety.

Opcje odinstalowywania

Te opcje są dostępne tylko dla niektórych typów projektów:

  • Usuń zależności: po wybraniu tej opcji ta opcja usuwa wszystkie pakiety zależne, jeśli nie odwołują się do nich w innym miejscu projektu.

  • Wymuś odinstalowanie, nawet jeśli istnieją zależności: po wybraniu tej opcji spowoduje odinstalowanie pakietu, nawet jeśli nadal występuje odwołanie do niego w projekcie. Ta opcja jest zwykle używana w połączeniu z usuwaniem zależności w celu usunięcia pakietu i zainstalowanych zależności. Jednak użycie tej opcji może prowadzić do błędnych odwołań w projekcie. W takim przypadku może być konieczne ponowne zainstalowanie tych innych pakietów.

  • Aby uzyskać filmy wideo dotyczące korzystania z pakietu NuGet do zarządzania pakietami, zobacz Channel 9 i YouTube.

Treści powiązane

Aby uzyskać więcej informacji na temat narzędzia NuGet, zobacz następujące artykuły:

  • Last updated on