使用 Visual Studio 包管理器控制台管理 NuGet 包

Visual Studio 中的包管理器控制台使用 PowerShell 命令与 NuGet 包进行交互。 当无法通过 包管理器 UI 执行操作时，可以使用控制台。 还可以在控制台中使用 dotnet CLI 或 NuGet CLI 命令。

本文介绍如何在包管理器控制台中使用 PowerShell 命令查找、安装、更新和卸载 NuGet 包。 有关完整的包管理器控制台 PowerShell 命令参考，请参阅 PowerShell 参考。

重要

本文中的 PowerShell 命令和参数特定于 Visual Studio 包管理器控制台。 这些命令不同于可在常规 PowerShell 环境中使用的 PackageManagement 模块命令 。 具体而言，每个环境都有一些命令，这些命令在其他环境中不可用，而具有相同名称的命令在其特定参数中也可能不同。

从 Visual Studio 2017 开始，在创建任何内容时，NuGet 和 NuGet 包管理器会自动安装。Visual Studio 中与 NET 相关的工作负荷。 还可以通过在Visual Studio 安装程序中选择单个组件>代码工具>NuGet 包管理器来安装包管理器。

还可以在“工具>扩展”和“汇报”或“扩展”菜单下搜索 NuGet 包管理器扩展。 如果无法在 Visual Studio 中使用扩展安装程序，可以直接从 https://dist.nuget.org/index.html 下载扩展。

包管理器控制台内置于 Windows 上的 Visual Studio 包管理器中。 Visual Studio Code和Visual Studio for Mac不包括控制台。 Visual Studio for Mac具有用于管理 NuGet 包的 UI，并且可通过 NuGet CLI 使用等效的控制台命令。 有关使用 NuGet 的详细信息，请参阅使用 NuGet 包管理器在 Visual Studio 中安装和管理包。

若要使用包管理器控制台快速查找并安装包，请执行以下操作：

在 Visual Studio 中打开项目或解决方案，然后选择 “工具>NuGet 包管理器>包管理器控制台 ”以打开“包管理器控制台”窗口。

在控制台中，输入 Find-Package 关键字以查找要安装的包。 例如，若要查找包含关键字 elmah的包，请运行以下命令。 如果已知道所需的包名称，请跳过此步骤。

找到名称后，使用 Install-Package 命令安装包。 例如，若要安装 Elmah.MVC 包，请输入：

有关这些命令的更多详细信息，请参阅 “查找包 并 安装包 ”部分。

提示

许多控制台操作依赖于在 Visual Studio 中通过已知路径名打开解决方案。 如果你有未保存的解决方案或没有解决方案，则会看到错误 解决方案未打开或未保存。请确保已打开并保存解决方案。 若要更正错误，请创建和保存解决方案，或保存未保存的解决方案。

若要在 Visual Studio 中打开包管理器控制台，请从顶部菜单中选择 “工具>NuGet 包管理器>管理器控制台 ”。 控制台是一个 Visual Studio 窗口，你可以根据需要排列和定位。 有关详细信息，请参阅在 Visual Studio 中自定义窗口布局。

默认情况下，控制台命令针对窗口顶部控件中设置的特定包源和项目执行操作：

选择不同的包源和/或项目会更改后续命令的默认值。 要在不更改默认值的情况下覆盖这些设置，大多数命令都支持 -Source 和 -ProjectName 选项。

若要管理包源，请选择齿轮图标，这将打开 “工具>选项>NuGet 包管理器>包源 ”对话框。 项目选择器旁边的控件清除控制台的内容。

最右侧的按钮中断了长时间运行的命令。 例如，运行 Get-Package -ListAvailable -PageSize 500 会列出默认源（例如 nuget.org）上的前 500 个包，这可能需要几分钟才能运行完毕。

若要在默认源中查找包，请使用 Find-Package。

若要查找并列出包含特定关键字的包：

若要查找并列出其名称以字符串开头的包：

默认情况下， Find-Package 返回 20 个包的列表。 用于 -First 显示更多包。 例如，若要显示前 100 个包，请使用：

列出特定包的所有版本：

若要将包安装到默认项目中，请使用 Install-Package 。 Install-Package 控制台命令执行以下操作：

默认情况下， Install-Package 将包添加到控制台窗口指定的默认项目中。 若要将包添加到不是默认值的项目，请使用 -ProjectName 该选项。 例如，若要将 Elmah.MVC 包添加到非默认 UtilitiesLib 项目，请运行以下命令：

若要从默认项目中卸载包，请使用 Uninstall-Package 。 如果需要查找包名称，请使用 Get-Package 查看默认项目中安装的所有包。

Uninstall-Package 执行以下操作：

若要卸载包及其所有未使用的依赖项，请运行：

若要卸载包，即使其他包依赖于它，请运行：

若要更新包，请使用 Get-Package 和 Update-Package。 可以运行以下命令：

检查是否有较新版本可用于任何已安装的包：

更新特定包：

更新项目中的所有包：

若要更新解决方案中的所有包，请执行以下操作：

还可以使用 NuGet CLI 执行大多数控制台操作。 但是，控制台命令在 Visual Studio 和已保存的项目/解决方案的上下文中运行，并且通常比其等效的 CLI 命令完成更多操作。 例如，通过控制台安装包会添加对项目的引用，而 CLI 命令则不会执行此操作。 因此，在 Visual Studio 中工作的开发人员通常更喜欢使用控制台命令，而不是 NuGet CLI。

若要在包管理器控制台中使用 NuGet CLI 命令，请安装 NuGet.CommandLine 包。

上述命令安装最新版本的 NuGet CLI。 若要安装特定版本，请使用 -Version 该选项。 例如，若要安装版本 4.4.1，请输入：

安装 NuGet.CommandLine 包后，可以通过包管理器控制台运行所有 NuGet CLI 命令。

某些包为控制台安装新命令。 例如，MvcScaffolding 创建如下所示的 Scaffold 命令，用于生成 ASP.NET MVC 控制器和视图：

可以创建 PowerShell 配置文件，使常用命令在所有 PowerShell 上下文中可用，因此不会丢失会话之间的 PowerShell 设置。 NuGet 支持特定于 NuGet 的配置文件，通常位于 %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1。

若要查找用户配置文件位置，请在控制台中输入 $profile ：

若要确定该位置是否存在配置文件，请输入 test-path $profile。 如果命令返回 False，则需要在该位置创建具有指定名称的配置文件。 有关详细信息，请参阅 Windows PowerShell 提示：