C# NuGet包管理命令

 

NuGet Package Manager Console 内置于 Visual Studio 在 Windows 2012 和更高版本。 （不包含在 Visual Studio 用于 Mac 或 Visual Studio Code。）

控制台，你可使用NuGet PowerShell 命令若要查找，安装、 卸载和更新 NuGet 程序包。 使用控制台是在包管理器 UI 不提供了如何执行操做的状况下必需的。 若要使用nuget.exe命令在控制台中，请参阅使用控制台中的 CLI nuget.exe。

例如，查找和安装的包，可以使用三个简单步骤：

1. 在 Visual Studio 中，打开项目/解决方案并打开控制台使用工具 > NuGet 包管理器 > 程序包管理器控制台命令。

2. 查找你想要安装的程序包。 若是你已经知道此，请跳到步骤 3。

   ps复制

   # Find packages containing the keyword "elmah" Find-Package elmah 

3. 运行安装命令：

   ps复制

   # Install the Elmah package to the project named MyProject. Install-Package Elmah -ProjectName MyProject 

重要

在控制台中可用的全部操做也均可以与NuGet CLI。 可是，控制台命令在 Visual Studio 和已保存的项目/解决方案的上下文中运行，而且一般完成多个其等效的 CLI 命令。 例如，安装经过控制台的包将引用添加到项目而 CLI 命令不运行。 为此，一般在 Visual Studio 中工做的开发人员喜欢使用 CLI 到控制台。

提示

许多控制台操做取决于使用已知的路径名称在 Visual Studio 中打开解决方案。 若是你有未保存的解决方案或没有解决方案，您能够看到此错误，"是未打开或保存解决方案。 请确保你已打开并保存解决方案。" 这表示控制台没法肯定解决方案的文件夹。 保存未保存的解决方案，或建立和保存解决方案，若是你尚未打开，应纠正该错误。

打开的控制台和控制台控件

1. 打开 Visual Studio 中使用控制台工具 > NuGet 包管理器 > 程序包管理器控制台命令。 在控制台中，能够排列和定位你的喜爱的 Visual Studio 窗口 (请参阅自定义 Visual Studio 中的窗口布局)。

2. 默认状况下，控制台命令运行针对特定的包源和项目中控件的窗口的顶部设置：

3. 选择一个不一样的包源和/或项目更改这些默认设置的后续命令。 覆盖而无需更改默认设置，这些设置的大多数命令支持-Source和-ProjectName选项。

4. 若要管理的包源，选择齿轮图标。 这是一个指向快捷方式工具 > 选项 > NuGet 包管理器 > 程序包源对话框上所述包管理器 UI页。 此外，右侧为项目选择器控件清除控制台的内容：

5. 最右边的按钮中断长时间运行的命令。 例如，运行Get-Package -ListAvailable -PageSize 500列出上默认源 （如 nuget.org)，可能须要几分钟时间运行的前 500 包。

安装的包

ps复制

# Add the Elmah package to the default project as specified in the console's project selector Install-Package Elmah # Add the Elmah package to a project named UtilitiesLib that is not the default Install-Package Elmah -ProjectName UtilitiesLib 

请参阅安装包。

安装的包执行下列操做：

• 与默示协议的控制台窗口中显示适用的许可条款。 若是你不一样意这些条款，你应当即卸载程序包。
• 在正在使用的任何引用格式添加到项目的引用。 引用随后将出如今解决方案资源管理器和适用的参考格式文件。 可是，请注意，采用 PackageReference，则须要先保存该项目才能直接看到项目文件中的更改。
• 缓存包：
  • PackageReference： 在缓存包%USERPROFILE%\.nuget\packages和锁定文件即project.assets.json更新。
  • packages.config： 建立packages在程序包文件入子文件夹中的解决方案根目录和副本的文件夹。 package.config更新文件。
• 更新app.config和/或web.config若是包使用源和配置文件转换。
• 若是项目中尚不存在，请安装任何依赖项。 中所述，这可能会更新在过程当中，包版本依赖项解析。
• 若是可用，请在 Visual Studio 窗口中显示包的自述文件。

提示

安装的包的主要优点之一Install-Package在控制台中的命令时，它将对项目的引用，就像使用程序包管理器 UI。 与此相反， nuget install CLI 命令仅下载包，并不会自动添加引用。

卸载包

ps复制

# Uninstalls the Elmah package from the default project Uninstall-Package Elmah # Uninstalls the Elmah package and all its unused dependencies Uninstall-Package Elmah -RemoveDependencies # Uninstalls the Elmah package even if another package depends on it Uninstall-Package Elmah -Force 

请参阅卸载包。 使用Get 包查看当前安装在默认项目中，若是你须要查找标识符的全部包。

卸载程序包执行下列操做：

• 将对包从项目 （和正在使用的任何引用格式） 的引用。 引用再也不出如今解决方案资源管理器。 (你可能须要从新生成该项目才能看到它从删除Bin文件夹。)
• 反转对所作任何更改app.config或web.config时已安装了包。
• 若是没有剩余的包使用这些依赖关系，依赖之前安装中删除项。

提示

如Install-Package、Uninstall-Package命令具备与管理在项目中，引用的好处nuget uninstallCLI 命令。

更新程序包

ps复制

# Checks if there are newer versions available for any installed packages Get-Package -updates # Updates a specific package using its identifier, in this case jQuery Update-Package jQuery # Update all packages in the project named MyProject (as it appears in Solution Explorer) Update-Package -ProjectName MyProject # Update all packages in the solution Update-Package 

请参阅Get 包和更新包

查找包

ps复制

# Find packages containing keywords Find-Package elmah Find-Package logging # List packages whose ID begins with Elmah Find-Package Elmah -StartWith # By default, Get-Package returns a list of 20 packages; use -First to show more Find-Package logging -First 100 # List all versions of the package with the ID of "jquery" Find-Package jquery -AllVersions -ExactMatch 

请参阅查找包。 在 Visual Studio 2013 和更早版本，使用Get 包相反。

控制台可用性

在 Visual Studio 2017，NuGet 和 NuGet 包管理器将自动安装时选择任何。提供与.NET 相关的工做负荷;你就能够还单独安装它，经过检查各个组件 > 代码工具 > NuGet 包管理器在 Visual Studio 2017 安装程序中的选项。

此外，若是你缺乏 NuGet 包管理器在 Visual Studio 2015 及更早版本，请检查工具 > 扩展和更新...和搜索 NuGet 包管理器扩展。 若是你没法使用 Visual Studio 中的扩展安装程序，你能够下载直接从扩展https://dist.nuget.org/index.html。

程序包管理器控制台不是当前适用于 Visual Studio for mac。 等效命令，可是，这些功能经过NuGet CLI。 适用于 Mac 的 visual Studio 也用于管理 NuGet 包存在一些 UI。 请参阅中你的项目包括 NuGet 包。

程序包管理器控制台不包括 Visual Studio 代码。

扩展包管理器控制台

某些包安装新的控制台的命令。 例如，MvcScaffolding建立等命令Scaffold下面所示，这将生成 ASP.NET MVC 控制器和视图：

设置 NuGet PowerShell 配置文件

PowerShell 配置文件，能够提供经常使用的命令，只要你使用 PowerShell。 NuGet 支持一般在如下位置找到 NuGet 特定配置文件：

复制

%UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1

若要查找配置文件，请键入$profile在控制台中：

ps复制

$profile C:\Users\<user>\Documents\WindowsPowerShell\NuGet_profile.ps1 

有关更多详细信息，请参阅Windows PowerShell 配置文件。

使用 nuget.exe CLI 在控制台中

若要使 nuget.exe CLI可用在程序包管理器控制台中，安装NuGet.CommandLine从控制台的包：

ps复制

# Other versions are available, see http://www.nuget.org/packages/NuGet.CommandLine/ Install-Package NuGet.CommandLine -Version 4.4.1