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

Средство командной строки dotnet (CLI) можно использовать в Windows, macOS или Linux для упрощения установки, удаления и обновления пакетов NuGet в .NET проектах и решениях. В этой статье описываются наиболее распространенные команды dotnet CLI для управления пакетами NuGet.

Интерфейс командной строки dotnet выполняется в .NET, .NET Core, .NET стандартных проектах пакета SDK и других проектах в стиле SDK, например тех, которые предназначены для платформы .NET Framework. Дополнительные сведения см. в пакетах SDK для проекта .NET.

Для большинства команд средство CLI ищет файл проекта в текущем каталоге, если другой файл проекта не указан как необязательный параметр в команде. Полный список команд и их аргументов см. в командах dotnet CLI.

Предпосылки

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

Установка или обновление пакета

Команда dotnet package add добавляет ссылку на пакет в файл проекта, а затем запускает dotnet restore для установки пакета.

  1. Откройте окно командной строки и перейдите в каталог, содержащий файл проекта.

  2. Чтобы установить пакет NuGet, используйте следующую команду:

    dotnet package add <package-name>

    Например, чтобы установить Newtonsoft.Json пакет, используйте следующую команду:

    dotnet package add Newtonsoft.Json

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

    dotnet add package <package-name>

  3. После завершения команды откройте файл проекта, чтобы проверить ссылку на пакет.

    Например, откройте CSPROJ-файл и проверьте ссылку на добавленный Newtonsoft.Json пакет:

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

Установка определенной версии пакета

Команда dotnet package add устанавливает последнюю версию пакета, если не указана другая версия.

Чтобы установить определенную версию пакета NuGet, используйте необязательный -v или --version переключатель:

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

Например, чтобы добавить версию 13.0.1 Newtonsoft.Json пакета, используйте следующую команду:

dotnet package add Newtonsoft.Json --version 13.0.1

Список ссылок на пакет

Команду списка пакетов dotnet можно использовать для перечисления ссылок на пакеты и версий проекта. В каталоге, содержающем файл проекта, выполните следующую команду:

dotnet package list

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

dotnet list package

Удалите пакет

Команду удаления пакета dotnet можно использовать для удаления ссылки на пакет из файла проекта. В каталоге, содержающем файл проекта, выполните следующую команду:

dotnet package remove <package-name>

Например, чтобы удалить Newtonsoft.Json пакет, используйте следующую команду:

dotnet package remove Newtonsoft.Json

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

dotnet remove package <package-name>

Восстановление пакетов

Команда dotnet restore восстанавливает пакеты, перечисленные в <PackageReference> элементах в файле проекта. Дополнительные сведения см. в файлах проекта PackageReference.

Начиная с .NET Core 2.0 и продолжая .NET, команды dotnet build и dotnet run автоматически восстанавливают пакеты, как и многие другие команды dotnet CLI. Поскольку в NuGet 4.0 dotnet restore запускает тот же код, что и команда nuget restore в NuGet CLI.

Для восстановления пакетов с помощью dotnet restore:

  1. Откройте окно командной строки и перейдите в каталог, содержащий файл проекта.
  2. Выполните dotnet restore.

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

  • Last updated on