install-use-packages-dotnet-cli.md

title	使用 dotnet CLI 安装和管理 NuGet 包
description	有关使用 dotnet CLI 处理 NuGet 包的说明。
author	mikejo5000
ms.author	mikejo
ms.date	06/03/2019
ms.topic	conceptual
ms.openlocfilehash	67cca81c48970c7f2e2cf0a64ee5ba57704a31e2
ms.sourcegitcommit	2b50c450cca521681a384aa466ab666679a40213
ms.translationtype	HT
ms.contentlocale	zh-CN
ms.lasthandoff	04/07/2020
ms.locfileid	74825151

使用 dotnet CLI 安装和管理包

通过 CLI 工具可轻松安装、卸载和更新项目和解决方案中的 NuGet 包。 它可在 Windows、Mac OS X 和 Linux 上运行。

dotnet CLI 适用于 .NET Core 和 .NET Standard 项目（SDK 样式的项目类型），以及任何其他 SDK 样式项目（例如，面向 .NET Framework 的 SDK 样式项目）。 有关更多信息，请参阅 SDK 属性。

本文介绍了一些最常见的 dotnet CLI 命令的基本用法。 对于这些中的大多数命令，CLI 工具在当前目录中查找项目文件，除非在命令中指定了项目文件（项目文件是一个可选开关）。 如需获取命令的完整列表和可能使用的参数，请参阅 .NET Core 命令行界面 (CLI) 工具。

必备条件

• .NET Core SDK，提供 dotnet 命令行工具。 从 Visual Studio 2017 开始，dotnet CLI 将自动随任何与 .NET Core 相关的工作负载一起安装。

安装包

dotnet add package 添加对项目文件的包引用，然后运行 dotnet restore 以安装包。

1. 打开命令行并切换到包含项目文件的目录。

2. 运行以下命令安装 Nuget 包：

   dotnet add package <PACKAGE_NAME>
   

   例如，若要安装 Newtonsoft.Json 包，请使用以下命令

   dotnet add package Newtonsoft.Json
   

3. 命令完成后，查看项目文件以确保已安装该包。

   可以打开 .csproj 文件以查看添加的引用：

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

安装特定版本的包

如果未指定版本，NuGet 将安装最新版本的包。 还可以使用 dotnet add package 命令安装特定版本的 Nuget 包：

dotnet add package <PACKAGE_NAME> -v <VERSION>

例如，要添加 Newtonsoft.Json 包的 12.0.1 版，请使用以下命令：

dotnet add package Newtonsoft.Json -v 12.0.1

NuGet 包引用

可以使用 dotnet list package 命令列出项目的包引用。

dotnet list package

删除包

使用 dotnet remove package 命令从项目文件中移除包引用。

dotnet remove package <PACKAGE_NAME>

例如，要移除 Newtonsoft.Json 包，请使用以下命令

dotnet remove package Newtonsoft.Json

更新包

除非指定包版本，否则 NuGet 会在使用 dotnet add package 命令时安装最新版本的包（-v 开关）。

还原包

[!INCLUDE restore-dotnet-cli]