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,然后运行 installrestore

使用情况

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

    指定要在包安装后保存的文件的类型:nuspecnupkgnuspec;nupkg

  • -PreRelease

    允许安装预发行包。 使用 packages.config 还原包时,不需要此标志。

  • -RequireConsent

    在下载和安装包之前,验证是否已启用还原包。 有关详细信息,请参阅包还原

  • -SolutionDirectory

    指定要为其还原包的解决方案的根文件夹。

  • -Source

    指定要使用的包源(作为 URL)的列表。 如果省略,该命令将使用配置文件中提供的源,请参阅通用 NuGet 配置

  • -Verbosity [normal|quiet|detailed]

    指定输出中显示的细节量:normal(默认值)、quietdetailed

  • -Version

    指定要安装的包的版本。

另请参阅环境变量

示例

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj