Condividi tramite

Installare e gestire pacchetti NuGet con l'interfaccia della riga di comando dotnet

È possibile usare lo strumento dotnet command-line interface (CLI) in Windows, macOS o Linux per installare, disinstallare e aggiornare facilmente i pacchetti NuGet in progetti e soluzioni .NET. Questo articolo descrive i comandi più comuni dell'interfaccia della riga di comando dotnet per la gestione dei pacchetti NuGet.

L'interfaccia della riga di comando dotnet viene eseguita su progetti .NET, .NET Core, .NET Standard di tipo SDK e su qualsiasi altro progetto in stile SDK, come ad esempio quelli che mirano a .NET Framework. Per altre informazioni, vedere SDK per progetti .NET.

Per la maggior parte dei comandi, lo strumento dell'interfaccia della riga di comando cerca un file di progetto nella directory corrente, a meno che non venga specificato un file di progetto diverso come opzione facoltativa nel comando. Per un elenco completo dei comandi e dei relativi argomenti, consultare i comandi CLI dotnet.

Prerequisiti

.NET SDK, che fornisce la CLI di dotnet. In Visual Studio, la dotnet CLI si installa automaticamente con tutti i workload correlati .NET.

Installare o aggiornare un pacchetto

Il comando dotnet package add aggiunge un riferimento al pacchetto al file di progetto e quindi viene eseguito dotnet restore per installare il pacchetto.

  1. Aprire una finestra della riga di comando e passare alla directory che contiene il file di progetto.

  2. Usare il comando seguente per installare un pacchetto NuGet:

    dotnet package add <package-name>

    Ad esempio, per installare il Newtonsoft.Json pacchetto, usare il comando seguente:

    dotnet package add Newtonsoft.Json

    Se si usa .NET 9 o versioni precedenti, usare invece la forma con il verbo all'inizio del comando:

    dotnet add package <package-name>

  3. Al termine del comando, aprire il file di progetto per verificare la presenza del riferimento al pacchetto.

    Ad esempio, aprire il file con estensione csproj e verificare la presenza del riferimento al pacchetto aggiunto Newtonsoft.Json :

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

Installare una versione specifica di un pacchetto

Il dotnet package add comando installa la versione più recente del pacchetto a meno che non si specifichi una versione diversa.

Per installare una versione specifica di un pacchetto NuGet, usare l'opzione facoltativa -v o --version:

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

Ad esempio, per aggiungere la versione 13.0.1 del Newtonsoft.Json pacchetto, usare questo comando:

dotnet package add Newtonsoft.Json --version 13.0.1

Elencare i riferimenti ai pacchetti

È possibile usare il comando dotnet package list per elencare i riferimenti e le versioni del pacchetto per il progetto. Dalla directory contenente il file di progetto eseguire il comando seguente:

dotnet package list

Se si utilizza .NET 9 o versioni precedenti, utilizzare invece la forma a verbo iniziale:

dotnet list package

Rimuovere un pacchetto

È possibile usare il comando dotnet package remove per rimuovere un riferimento al pacchetto dal file di progetto. Dalla directory contenente il file di progetto eseguire il comando seguente:

dotnet package remove <package-name>

Ad esempio, per rimuovere il Newtonsoft.Json pacchetto, usare il comando seguente:

dotnet package remove Newtonsoft.Json

Se si utilizza .NET 9 o versioni precedenti, utilizzare invece la forma a verbo iniziale:

dotnet remove package <package-name>

Ripristinare i pacchetti

Il dotnet restore comando ripristina i pacchetti elencati negli <PackageReference> elementi nel file di progetto. Per altre informazioni, vedere PackageReference nei file di progetto.

A partire da .NET Core 2.0 e continuando con .NET, i comandi dotnet build e dotnet run ripristinano automaticamente i pacchetti, come molti altri comandi dell'interfaccia della riga di comando dotnet. A partire da NuGet 4.0, dotnet restore esegue lo stesso codice del comando della CLI di nuget restore NuGet.

Per ripristinare i pacchetti tramite dotnet restore:

  1. Aprire una finestra della riga di comando e passare alla directory che contiene il file di progetto.
  2. Eseguire dotnet restore.

Contenuti correlati

  • Last updated on