Поделиться через

Краткое руководство. Установка и использование пакета с помощью dotnet CLI

В этом кратком руководстве вы установите популярный пакет NuGet Newtonsoft.Json в проект .NET. Пакеты NuGet содержат скомпилированный двоичный код, который разработчики предоставляют другим разработчикам для использования в своих проектах. Для получения дополнительной информации см. статью "Введение в NuGet".

Чтобы установить пакет, используйте команду add package dotnet , которая входит в интерфейс командной строки dotnet (CLI).

Подсказка

Просмотрите nuget.org/packages , чтобы найти пакеты, которые можно повторно использовать в собственных приложениях. Вы можете выполнить поиск непосредственно в https://nuget.org/packages или найти и установить пакеты из Visual Studio. Дополнительные сведения см. в статье "Поиск и оценка пакетов NuGet" для проекта.

Предпосылки

Пакет SDK .NET, обеспечивающий интерфейс командной строки dotnet. В Visual Studio интерфейс командной строки dotnet автоматически устанавливается вместе с любыми рабочими нагрузками, связанными с .NET.

Создание проекта

Пакеты NuGet можно установить в проект .NET. Для этого краткого руководства выполните следующие действия, чтобы создать базовый проект консоли .NET с помощью dotnet CLI:

  1. Создайте папку с именем Nuget.Quickstart для проекта.

  2. Откройте окно командной строки и перейдите в новую папку.

  3. Создайте проект с помощью следующей команды:

    dotnet new console

  4. Используется dotnet run для тестирования приложения. Команда записывает следующие выходные данные на экран: Hello, World!

Добавьте пакет Newtonsoft.Json из NuGet

  1. Чтобы установить пакет Newtonsoft.Json, выполните следующую команду:

    dotnet package add Newtonsoft.Json

    Если вы используете .NET 9 или более ранних версий, используйте вместо этого форму глагола:

    dotnet add package Newtonsoft.Json

  2. После завершения команды откройте файл Nuget.Quickstart.csproj в Visual Studio или текстовом редакторе. Проверьте добавленную ссылку на пакет NuGet:

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

Использование API Newtonsoft.Json в приложении

В коде вы ссылаетесь на установленные пакеты с помощью using <namespace> директивы, где <namespace> часто используется имя пакета. Затем вы можете использовать API пакета в проекте.

  1. В Visual Studio или текстовом редакторе откройте файл Program.cs. Добавьте следующую строку в начало файла:

    using Newtonsoft.Json;

  2. Добавьте следующий код для замены инструкции 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. Сохраните файл, а затем создайте и запустите приложение с помощью dotnet run команды. Выходные данные — это представление Account объекта в коде в формате JSON:

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

Видео об использовании NuGet для управления пакетами см. в статье .NET Управление пакетами с помощью NuGet для начинающих и NuGet для начинающих.

Связанный контент

Дополнительные сведения об установке и использовании пакетов NuGet с помощью dotnet CLI см. в следующих статьях:

  • Last updated on