install 命令 (NuGet CLI)
适用于:包使用 • 支持的版本:全部
使用指定的包源将包下载并安装到项目中,且默认安装到当前文件夹。
提示
若要直接在项目上下文之外下载包,请访问 nuget.org 上的包页面,然后选择下载链接。
如果未指定任何源,则使用全局配置文件 %appdata%\NuGet\NuGet.Config
(适用于 Windows)或 ~/.nuget/NuGet/NuGet.Config
(适用于 Mac/Linux)中列出的源。 有关更多详细信息,请参阅常见 NuGet 配置。
如果未指定特定包,install
则会安装项目的 packages.config
文件中列出的所有包,从而使其类似于 restore
。
install
命令不会修改项目文件或 packages.config
;在此方式下,它类似于 restore
,因为它只向磁盘添加包,而不更改项目的依赖项。
要添加依赖项,请通过 Visual Studio 中的包管理器 UI 或控制台添加包,或是修改 packages.config
,然后运行 install
或 restore
。
使用情况
nuget install <packageID | configFilePath> [options]
其中,<packageID>
会命名待安装的包(使用最新版本),或是 <configFilePath>
标识出会列出待安装包的 packages.config
文件。 可使用 -Version
选项指示特定版本。
选项
-ConfigFile
要应用的 NuGet 配置文件。 如果未指定,则使用
%AppData%\NuGet\NuGet.Config
(适用于 Windows)或是~/.nuget/NuGet/NuGet.Config
或~/.config/NuGet/NuGet.Config
(适用于 Mac/Linux)。-DependencyVersion
(4.4+) 待使用依赖项包的版本,它可为以下版本之一:
- Lowest(默认值):最低版本
- HighestPatch:具有最低主要、最低次要、最高修补程序的版本
- HighestMinor:具有最低主要、最高次要、最高修补程序的版本
- Highest:最高版本
- Ignore:不使用依赖项包
-DirectDownload
直接下载,而不使用元数据或二进制文件填充任何缓存。
-DisableParallelProcessing
禁用并行安装多个包。
-x|-ExcludeVersion
将包安装到仅用包名称而不是版本号来命名的文件夹。
-FallbackSource
(3.2+) 在主源或默认源中未找到包源时用作回退的包源的列表。
-ForceEnglishOutput
(3.5+) 使用固定的、基于英语的区域性强制 nuget.exe 运行。
-Framework
(4.4+) 用于选择依赖项的目标框架。 默认为“Any”(如果未指定)。
-?|-help
显示此命令的帮助信息。
-NoHttpCache
阻止 NuGet 使用 http 已缓存的包。 请参阅管理全局包和缓存文件夹。
-NonInteractive
不为用户输入或确认显示提示。
-OutputDirectory
指定要在其中安装包的文件夹。 如果未指定文件夹,则使用当前文件夹。
-PackageSaveMode
指定要在包安装后保存的文件的类型:
nuspec
、nupkg
或nuspec;nupkg
。-PreRelease
允许安装预发行包。 使用
packages.config
还原包时,不需要此标志。-RequireConsent
在下载和安装包之前,验证是否已启用还原包。 有关详细信息,请参阅包还原。
-SolutionDirectory
指定要为其还原包的解决方案的根文件夹。
-Source
指定要使用的包源(作为 URL)的列表。 如果省略,该命令将使用配置文件中提供的源,请参阅通用 NuGet 配置。
-Verbosity [normal|quiet|detailed]
指定输出中显示的细节量:
normal
(默认值)、quiet
或detailed
。-Version
指定要安装的包的版本。
另请参阅环境变量
示例
nuget install elmah
nuget install packages.config
nuget install ninject -OutputDirectory c:\proj