Inicio rápido: Instalación y uso de un paquete con la CLI de dotnet

En este inicio rápido, instalarás el popular paquete NuGet Newtonsoft.Json dentro de un proyecto de .NET. Los paquetes NuGet contienen código binario compilado que los desarrolladores hacen disponibles para que otros desarrolladores los usen en sus proyectos. Para obtener más información, consulte Introducción a NuGet.

Para instalar el paquete, use el comando dotnet package add , que forma parte de la interfaz de la línea de comandos (CLI) de dotnet.

Sugerencia

Examine nuget.org/packages para buscar paquetes que puede reutilizar en sus propias aplicaciones. Puede buscar directamente en https://nuget.org/packages, o puede encontrar e instalar paquetes desde Visual Studio. Para obtener más información, consulte Búsqueda y evaluación de paquetes NuGet para el proyecto.

Prerrequisitos

El SDK .NET, que proporciona la CLI de Dotnet. En Visual Studio, la CLI de dotnet se instala automáticamente con cualquier carga de trabajo relacionada con .NET.

Creación de un proyecto

Puede instalar paquetes NuGet en un proyecto de .NET. Para este inicio rápido, siga estos pasos para crear un proyecto básico de consola de .NET mediante la CLI de dotnet:

  1. Cree una carpeta denominada Nuget.Quickstart para el proyecto.

  2. Abra el símbolo del sistema y dirígete a la nueva carpeta.

  3. Cree el proyecto mediante el comando siguiente:

    dotnet new console

  4. Use dotnet run para probar la aplicación. El comando escribe la siguiente salida en la pantalla: Hello, World!.

Añade el paquete NuGet Newtonsoft.Json

  1. Use el comando siguiente para instalar el paquete Newtonsoft.Json:

    dotnet package add Newtonsoft.Json

    Si usa .NET 9 o versiones anteriores, utilice en su lugar la forma con el verbo primero.

    dotnet add package Newtonsoft.Json

  2. Una vez finalizado el comando, abra el archivo Nuget.Quickstart.csproj en Visual Studio o en un editor de texto. Busque la referencia del paquete NuGet agregada:

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

Uso de la API Newtonsoft.Json en la aplicación

En el código, se hace referencia a los paquetes instalados mediante una using <namespace> directiva , donde <namespace> suele ser el nombre del paquete. Después, puede usar la API del paquete en el proyecto.

  1. En Visual Studio o en un editor de texto, abra el archivo Program.cs. Agregue la siguiente línea a la parte superior del archivo:

    using Newtonsoft.Json;

  2. Agregue el código siguiente para reemplazar la Console.WriteLine("Hello, World!"); instrucción :

    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. Guarde el archivo y, a continuación, compile y ejecute la aplicación mediante el dotnet run comando . La salida es la representación JSON del Account objeto en el código:

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

Para obtener vídeos sobre el uso de NuGet para la administración de paquetes, consulte .NET Administración de paquetes con NuGet para principiantes y NuGet para principiantes.

Contenido relacionado

Para obtener más información sobre cómo instalar y usar paquetes NuGet mediante la CLI de dotnet, consulte los artículos siguientes:

  • Last updated on