Installare e gestire pacchetti in Visual Studio usando il Package Manager NuGet

È possibile usare l'interfaccia utente di nuGet Package Manager in Microsoft Visual Studio per installare, disinstallare e aggiornare facilmente i pacchetti NuGet nei progetti e nelle soluzioni.

Prerequisiti

Visual Studio 2026 con qualsiasi carico di lavoro correlato .NET. È possibile installare gratuitamente l'edizione Community 2026 da visualstudio.microsoft.com oppure è possibile usare l'edizione Professional o Enterprise.
Gestore pacchetti NuGet. Visual Studio 2017 e versioni successive includono automaticamente il Package Manager NuGet quando viene installato un carico di lavoro correlato .NET. Per installare manualmente il Package Manager NuGet nel programma di installazione di Visual Studio, selezionare Individual components>Code tools>NuGet package manager.

Trovare e installare un pacchetto

Per trovare e installare un pacchetto NuGet usando Visual Studio, seguire questa procedura:

Caricare un project in Solution Explorer e quindi selezionare Project>Gestisci pacchetti NuGet.

La finestra NuGet Package Manager verrà visualizzata.
Passare alla scheda Sfoglia per visualizzare i pacchetti in base alla popolarità dall'origine attualmente selezionata. Per informazioni sulle origini, vedere Origini dei pacchetti.
- Per cercare un pacchetto specifico, usare la casella di ricerca nell'angolo superiore sinistro della scheda.
- Le informazioni abbreviate potrebbero essere visualizzate accanto a ogni ID pacchetto per identificare il pacchetto corretto. Queste informazioni variano in base alle origini dei pacchetti selezionate. Gli esempi includono il numero di download del pacchetto, gli autori o un collegamento al profilo del proprietario.
Annotazioni

In Visual Studio 17.11 e versioni successive, i proprietari dei pacchetti vengono visualizzati come collegamenti di profilo se supportati dall'origine del pacchetto selezionata. La proprietà del pacchetto è definita dall'origine del pacchetto. Per altre informazioni, vedere Gestire i proprietari dei pacchetti in nuget.org.

In Visual Studio 17.10 e versioni precedenti viene visualizzato il pacchetto author metadati, che viene visualizzato come testo normale. Per ulteriori informazioni, vedere metadati del pacchetto degli autori.
- Selezionare un pacchetto per aprire il relativo riquadro dei dettagli. Nel riquadro dei dettagli, nella scheda Dettagli pacchetto vengono visualizzati i metadati del pacchetto, le informazioni sui proprietari, gli autori e la licenza e altre informazioni. Il riquadro dei dettagli consente anche di selezionare una versione da installare.
  
  La scheda README del riquadro dei dettagli visualizza il file read-me del pacchetto, se fornito dall'autore del pacchetto.
Nel riquadro dei dettagli, accanto a Versione, selezionare una versione. Per includere versioni non definitive nell'elenco Version, passare alla parte superiore della finestra NuGet Package Manager. Accanto alla casella di ricerca selezionare Includi versione preliminare.
Per installare il pacchetto NuGet, selezionare Installa. Potrebbe essere richiesto di accettare le condizioni di licenza o di verificare l'installazione.

Visual Studio installa il pacchetto e le relative dipendenze nel progetto. Al termine dell'installazione, i pacchetti aggiunti vengono visualizzati nella scheda NuGet Package Manager Installed. È anche possibile trovare pacchetti in Solution Explorer, nel nodo Dependencies>Packages. Dopo aver installato un pacchetto, è possibile farvi riferimento nel progetto con un'istruzione using .

Impostare il formato di gestione dei pacchetti

NuGet ha due formati in cui un progetto può usare pacchetti:

Solo alcuni tipi di progetti supportano entrambi i formati di gestione dei pacchetti. In particolare, i progetti framework di .NET non in stile SDK con un file .csproj supportano entrambi i formati. Per i progetti dello stile SDK .NET, PackageReference è richiesto.

Il formato consigliato è PackageReference. Alcuni pacchetti NuGet, tuttavia, non sono completamente compatibili con PackageReference. Per altre informazioni, vedere Problemi di compatibilità dei pacchetti.

Per altre informazioni sui formati di gestione dei pacchetti, vedere Migrare da packages.config a PackageReference e Supporto dei tipi di progetto.

Per impostare il formato predefinito, seguire questa procedura:

In Visual Studio selezionare Tools>Opzioni.
Nel riquadro laterale selezionare NuGet Package Manager e quindi selezionare General.
Nella finestra principale, in Gestione pacchetti, selezionare un formato nell'elenco Formato di gestione pacchetti predefinito .

Per altre informazioni sulla configurazione di questa impostazione, vedere Scegliere il formato di gestione dei pacchetti predefinito.

Disinstallare un pacchetto

Per disinstallare un pacchetto NuGet, seguire questa procedura:

Caricare un project in Solution Explorer, selezionare Project>Gestisci pacchetti NuGet e quindi passare alla scheda Installed.
Nel riquadro principale selezionare il pacchetto da disinstallare. Se necessario, usare la casella di ricerca per trovare il pacchetto. Quindi, nel riquadro dei dettagli del pacchetto selezionare Disinstalla.

Aggiornare un pacchetto

Per aggiornare un pacchetto NuGet, seguire questa procedura:

Caricare un project in Solution Explorer e quindi selezionare Project>Gestisci pacchetti NuGet. Per i progetti di siti Web legacy ASP.NET, che gestiscono le dipendenze tramite la cartella bin, passare alla cartella Solution Explorer e selezionare la cartella bin prima di aprire l'interfaccia utente di NuGet Package Manager.
Selezionare la scheda Aggiornamenti per elencare i pacchetti con aggiornamenti disponibili dall'origine selezionata accanto a Origine pacchetto. Per includere pacchetti non definitive nell'elenco degli aggiornamenti, passare alla parte superiore della finestra NuGet Package Manager. Accanto alla casella di ricerca selezionare Includi versione preliminare.
Selezionare il pacchetto da aggiornare. Nel riquadro dei dettagli, accanto a Versione, selezionare la versione desiderata e quindi selezionare Aggiorna.

Aggiornare un pacchetto a cui si fa riferimento in modo implicito

Per alcuni pacchetti, il pulsante Aggiorna non è disponibile e viene visualizzato il messaggio seguente: "Fa riferimento implicito a un SDK. Per aggiornare il pacchetto, aggiornare l'SDK a cui appartiene."

Questo messaggio indica che il pacchetto fa parte di un framework o un SDK di dimensioni maggiori e non può essere aggiornato in modo indipendente. Ad esempio, Microsoft.NETFramework.ReferenceAssemblies viene aggiunto automaticamente quando un progetto in stile SDK è destinato a .NET Framework.

Tali pacchetti vengono contrassegnati internamente con <IsImplicitlyDefined>True</IsImplicitlyDefined>. Questi pacchetti seguono la versione dell'SDK o del runtime e devono essere aggiornati installando una versione più recente dell'SDK di .NET, anziché usando il NuGet Package Manager.

Per scaricare una nuova versione di un framework, vedere Download .NET. Per altre informazioni, vedere panoramica della pubblicazione di applicazioni .NET.

Aggiornare più pacchetti

Per aggiornare più pacchetti alle versioni più recenti, selezionarli nell'elenco dei pacchetti NuGet e quindi selezionare Aggiorna.

Aggiorna dalla scheda Installato

È anche possibile aggiornare un singolo pacchetto dalla scheda Installato . In questo caso, è anche possibile selezionare una versione e l'opzione Includi versione non definitiva .

Gestire i pacchetti per la soluzione

La gestione dei pacchetti per una soluzione è un modo pratico per lavorare contemporaneamente con più progetti.

Selezionare una soluzione in Solution Manager, quindi selezionare Tools>NuGet Package Manager>Manage NuGet Packages for Solution.
Nella finestra Gestisci pacchetti per soluzione selezionare i progetti a cui applicare un'operazione.

Scheda di consolidamento

Gli sviluppatori considerano in genere una cattiva pratica usare versioni diverse dello stesso pacchetto NuGet in progetti diversi all'interno della stessa soluzione. È possibile utilizzare la finestra Gestisci pacchetti per la soluzione per applicare una versione comune ai pacchetti NuGet. A tale scopo, passare alla scheda Consolida per individuare dove i pacchetti con numeri di versione distinti vengono usati da progetti diversi nella soluzione.

In questo esempio il progetto MyClassLibrary usa EntityFramework la versione 6.5.1, ma MyConsoleApp usa EntityFramework la versione 6.5.0. Per consolidare le versioni dei pacchetti, seguire questa procedura:

Nella scheda Consolida selezionare i progetti da aggiornare nell'elenco dei progetti.
Accanto a Versione selezionare la versione da usare per tutti i progetti selezionati.
Selezionare Installa.

Il Package Manager NuGet installa la versione del pacchetto selezionata in tutti i progetti selezionati e il pacchetto non viene più visualizzato nella scheda Consolidate.

Fonti dei pacchetti

Visual Studio ignora l'ordine delle origini dei pacchetti. Usa invece il pacchetto dall'origine che risponde prima a una richiesta. Per altre informazioni, vedere Ripristinare i pacchetti. Per informazioni su come caricare un pacchetto da un'origine specifica, vedere Mapping dell'origine del pacchetto.

Per modificare l'origine da cui Visual Studio carica i metadati del pacchetto, passare alla parte superiore della finestra NuGet Package Manager o Gestisci pacchetti per soluzione. Accanto a Origine pacchetto selezionare l'origine da usare.
Per gestire le origini dei pacchetti, selezionare l'icona Impostazioni o selezionare Opzioni strumenti>.
Per gestire le origini dei pacchetti NuGet, vedere Opzioni di Package Manager NuGet in Visual Studio.

Opzioni di controllo del Package Manager NuGet

Quando si seleziona un pacchetto, il NuGet Package Manager visualizza un controllo espandibile Opzioni nel riquadro dei dettagli, sotto l'elenco Version. Per la maggior parte dei tipi di progetto, viene fornita solo la casella di controllo Mostra finestra di anteprima . Tuttavia, per alcuni tipi di progetto sono disponibili anche altre opzioni.

Le sezioni seguenti illustrano le opzioni disponibili.

Opzioni di installazione e aggiornamento

Queste opzioni sono disponibili solo per determinati tipi di progetto:

Comportamento delle dipendenze: questa opzione specifica le versioni dei pacchetti dipendenti installati da NuGet. Include le impostazioni seguenti:
- Ignora dipendenze salta l'installazione delle dipendenze, il che generalmente danneggia il pacchetto da installare.
- Versione minima installa la dipendenza con il numero di versione minimo che soddisfa i requisiti del pacchetto principale scelto. Questa impostazione è quella predefinita.
- La patch più alta installa la versione con gli stessi numeri di versione principale e secondaria della versione selezionata, ma il numero di patch più alto. Ad esempio, se viene specificata la versione 1.2.2, viene installata la versione più recente che inizia con la versione 1.2.
- Il numero minore più alto installa la versione con lo stesso numero di versione principale della versione selezionata, ma con il numero minore e il numero di patch più alto. Se viene specificata la versione 1.2.2, viene installata la versione più recente che inizia con 1.
- Il livello massimo installa la versione più recente disponibile del pacchetto.
Azione di conflitto di file: questa opzione specifica il modo in cui NuGet gestisce i pacchetti già esistenti nel progetto o nel computer locale. Include le impostazioni seguenti:
- Prompt indica a NuGet di chiedere se conservare o sovrascrivere i pacchetti esistenti.
- Ignora tutto indica a NuGet di ignorare la sovrascrittura di tutti i pacchetti esistenti.
- Sovrascrivere Tutto indica a NuGet di sovrascrivere tutti i pacchetti esistenti.

Opzioni di disinstallazione