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