Guida introduttiva: Installare e usare un pacchetto con la CLI dotnet

In questo avvio rapido, si installa il popolare pacchetto NuGet Newtonsoft.Json in un progetto .NET. I pacchetti NuGet contengono codice binario compilato che gli sviluppatori rendono disponibili ad altri sviluppatori per l'uso nei progetti. Per altre informazioni, vedere Introduzione a NuGet.

Per installare il pacchetto, usare il comando dotnet package add , che fa parte dell'interfaccia della riga di comando dotnet.

Suggerimento

Esplorare nuget.org/packages per trovare i pacchetti che è possibile riutilizzare nelle proprie applicazioni. È possibile cercare direttamente in https://nuget.org/packages oppure trovare e installare pacchetti da Visual Studio. Per altre informazioni, vedere Trovare e valutare i pacchetti NuGet per il progetto.

Prerequisiti

.NET SDK, che fornisce la CLI di dotnet. In Visual Studio, la CLI dotnet viene installata automaticamente con qualsiasi workload .NET.

Creare un progetto

È possibile installare pacchetti NuGet in un progetto di .NET. Per questa guida introduttiva, seguire questa procedura per creare un progetto console di base .NET usando l'interfaccia della riga di comando dotnet:

  1. Creare una cartella denominata Nuget.Quickstart per il progetto.

  2. Aprire una finestra del prompt dei comandi e passare alla nuova cartella.

  3. Creare il progetto usando il comando seguente:

    dotnet new console

  4. Usare dotnet run per testare l'app. Il comando scrive l'output seguente nella schermata: Hello, World!.

Aggiungere il pacchetto NuGet Newtonsoft.Json

  1. Usare il comando seguente per installare il pacchetto Newtonsoft.Json:

    dotnet package add Newtonsoft.Json

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

    dotnet add package Newtonsoft.Json

  2. Al termine del comando, aprire il file Nuget.Quickstart.csproj in Visual Studio o in un editor di testo. Verificare la presenza del riferimento al pacchetto NuGet aggiunto:

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

Usare l'API Newtonsoft.Json nell'app

Nel codice si fa riferimento ai pacchetti installati usando una using <namespace> direttiva, dove <namespace> è spesso il nome del pacchetto. È quindi possibile usare l'API del pacchetto nel progetto.

  1. In Visual Studio o in un editor di testo aprire il file Program.cs. Aggiungere la riga seguente all'inizio del file:

    using Newtonsoft.Json;

  2. Aggiungere il codice seguente per sostituire l'istruzione Console.WriteLine("Hello, World!"); :

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Id { get; set; }
        public decimal Balance { get; set; }
        public DateTime Created { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Id = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
                Balance = 4389.21m,
                Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Salvare il file e quindi compilare ed eseguire l'app usando il dotnet run comando . L'output è la rappresentazione JSON dell'oggetto Account nel codice:

    {
  "Id": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
  "Balance": 4389.21,
  "Created": "2026-04-16T00:00:00Z"
}

Per video sull'uso di NuGet per la gestione dei pacchetti, vedere .NET Package Management con NuGet per principianti e NuGet per principianti.

Contenuti correlati

Per altre informazioni sull'installazione e l'uso di pacchetti NuGet tramite l'interfaccia della riga di comando dotnet, vedere gli articoli seguenti:

  • Last updated on