NuGet CLI 引用

NuGet 命令行接口 (CLI) , nuget.exe 提供完整的 NuGet 功能,用于安装、创建、发布和管理包,而无需对项目文件进行任何更改。

若要使用任何命令,请打开命令窗口或 bash shell,然后运行 nuget 命令和相应的选项,例如 nuget help pack (查看包命令) 的帮助。

本文档反映 NuGet CLI 的最新版本。 有关所使用的任何给定版本的确切详细信息,请运行 nuget help 以获取所需的命令。

要了解如何在 nuget.exe CLI 中使用基本命令,请参阅使用 nuget.exe CLI 安装并使用包

安装 nuget.exe

Windows

注意

NuGet.exe 5.0 及更高版本需要 .NET Framework 4.7.2 或更高版本才能执行。

  1. 请访问 nuget.org/downloads,并选择 NuGet 3.3 或更高版本(2.8.6 与 Mono 不兼容)。 始终建议使用最新版。若要将包发布到 nuget.org,版本至少必须是 4.1.0。
  2. 每次下载都直接下载 nuget.exe 文件。 让浏览器将文件保存到选定文件夹。 此文件不是安装程序;如果直接在浏览器中运行,就不会看到任何内容。
  3. 将文件夹添加到 nuget.exe 中放置 PATH 环境变量的位置,这样就可以从任意位置使用 CLI 工具。

macOS/Linux

行为可能因 OS 分发版本略有不同。

  1. 安装 Mono 4.4.2 或更高版本

  2. 在 shell 提示符处,执行下列命令:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. 通过将以下脚本添加到 OS 的相应文件来创建别名(通常为 ~/.bash_aliases~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. 重载 shell。 通过输入 nuget(而不使用任何参数)来测试安装。 应该会看到 NuGet CLI 帮助。

提示

若要使 NuGet CLI 在 Visual Studio 的程序包管理器控制台内可用,请参阅控制台中的使用 nuget.exe CLI

可用性

有关详细信息,请参阅 功能可用性

  • Windows 上提供所有命令。
  • 所有命令都适用于在 Mono 上运行的 nuget.exe,但指示、 restoreupdatepack 情况除外。
  • pack在 Mac 和 Linux 上,通过 dotnet CLI 还可以使用、 localsrestoredelete 、、和 push 命令。

命令和适用性

可用命令和对包创建、包使用和/或将包发布到主机的适用性:

常见命令 适用的角色 NuGet 版本 说明
pack 创建 2.7+ .nuspec 或项目文件创建 NuGet 包。 在 Mono 上运行时,不支持从项目文件创建包。
push 发布 All 将包发布到包源。
config All 全部 获取或设置 NuGet 配置值。
help or ? 全部 全部 显示命令的帮助信息或帮助。
locals 消耗 3.3 + 列出 全局包http 缓存临时 文件夹的位置,并清除这些文件夹的内容。
restore 消耗 2.7+ 还原使用中的包管理格式所引用的所有包。 在 Mono 上运行时,不支持使用 PackageReference 格式还原包。
setapikey 发布,消耗 All 当包源需要访问密钥时,保存给定包源的 API 密钥。
spec 创建 全部 .nuspec使用标记生成文件(如果从 Visual Studio 项目生成文件)。
辅助命令 适用的角色 NuGet 版本 说明
add 发布 3.3 + 使用分层布局将包添加到非 HTTP 包源。 对于 HTTP 源,请使用 push
delete 发布 All 从包源中删除或取消列出包。
init 创建 3.3 + 使用分层布局,将文件夹中的包添加到包源。
install 消耗 全部 将包安装到当前项目中,但不修改项目或引用文件。
list 消耗,可能正在发布 All 显示来自给定源的包。
mirror 发布 在 3.2+ 中弃用 将包及其依赖项从源镜像到目标存储库。
search 消耗 5.8+ 使用提供的查询字符串搜索给定源。
sources 消耗、发布 All 管理配置文件中的包源。
update 消耗 All 将项目的包更新到最新的可用版本。 在 Mono 上运行时不受支持。

不同的命令使用各种 环境变量

NuGet角色使用 CLI 命令:

角色 命令
消耗 config, help, install, list, locals, restore, search, setapikey, sources, update
创建 config, help, init, pack, spec
发布 add, config, delete, help, list, push, setapikey, sources

例如,仅关注使用包的开发人员只需了解命令NuGet子集。

注意

命令选项名称不区分大小写。 此引用中不包含NoPromptNonInteractiveVerbose 已弃用的选项,例如 (替换为) , (替换为) 。Verbosity