大网数据广告活动
.NET 与 C# 开发

dotnet restore 命令

· 52CE 我爱测

了解如何使用 dotnet-restore 命令还原依赖项和特定于项目的工具。

本主题适用于:✓ .NET Core 1.x SDK ✓ .NET Core 2.x SDK

name

dotnet restore - 恢复项目的依赖项和工具。

摘要

.NET Core 2.x

dotnet restore [<ROOT>] [--configfile] [--disable-parallel] [--force] [--ignore-failed-sources] [--no-cache]
    [--no-dependencies] [--packages] [-r|--runtime] [-s|--source] [-v|--verbosity] [--interactive]
dotnet restore [-h|--help]

.NET Core 1.x

dotnet restore [<ROOT>] [--configfile] [--disable-parallel] [--ignore-failed-sources] [--no-cache]
    [--no-dependencies] [--packages] [-r|--runtime] [-s|--source] [-v|--verbosity]
dotnet restore [-h|--help]

说明

dotnet restore 命令使用 NuGet 还原依赖项以及在 project 文件中指定的特定于项目的工具。 默认情况下会并行执行对依赖项和工具的还原。

Note: 从 .NET Core 2.0 SDK 开始,无需运行 dotnet restore,因为它由所有需要还原的命令隐式运行,如 dotnet new、dotnet build 和 dotnet run。 在执行显式还原有意义的某些情况下,例如 Azure DevOps Services 中的持续集成生成中,或在需要显式控制还原发生时间的生成系统中,它仍然是有效的命令。

为了还原依赖项,NuGet 需要包所在的源。 通常通过“nuGet.config”配置文件提供源 。 安装 CLI 工具时提供一个默认的配置文件。 可以通过在项目目录中创建自己的 nuGet.config 文件来指定其他源 。 也可以在命令提示符处指定每次调用的其他源。

对于依赖项,使用 --packages 参数指定还原操作期间放置还原包的位置。 如未指定,将使用默认的 NuGet 包缓存,可在所有操作系统上的用户主目录中的 .nuget/packages 目录找到它。 例如 Linux 上的 /home/user1 或 Windows 上的 C:\Users\user1 。

对于特定于项目的工具,dotnet restore 首先还原打包工具所在的包,然后继续还原 project 文件中指定的工具依赖项。

nuget.config 差异

dotnet restore 命令的行为会受 Nuget.Config 文件(如果有)中某些设置的影响 。 例如,在 NuGet.Config 中设置 globalPackagesFolder 会将还原的 NuGet 包置于指定的文件夹中 。 这是在 dotnet restore 命令中指定 --packages 选项的替代方法。 有关详细信息,请参阅 nuget.config 参考。

有三个 dotnet restore 可忽略的特定设置:

  • bindingRedirects

    绑定重定向不适用于 <PackageReference> 元素,并且 .NET Core 仅支持 NuGet 包的 <PackageReference> 元素。

  • 解决方案

    此设置特定于 Visual Studio,不适用于 .NET Core。 .Net Core 不使用 packages.config 文件,而是使用 NuGet 包的 <PackageReference> 元素。

  • trustedSigners

    此设置不适用,如 NuGet 尚不支持跨平台验证受信任包所述。

隐式 dotnet restore

从 .Net Core 2.0 开始,当发出下列命令时,如有必要,将隐式运行 dotnet restore。

在大多数情况下,不再需要显式使用 dotnet restore 命令。

有时,隐式运行 dotnet restore 可能不方便。 例如,某些自动化系统(如生成系统)需要显式调用 dotnet restore,以控制还原发生的时间,以便可以控制网络使用量。 要防止隐式运行 dotnet restore,可以通过上述任意命令使用 --no-restore 标记以禁用隐式还原。

自变量

ROOT

要还原的项目文件的可选路径。

选项

.NET Core 2.x

--configfile <FILE>

供还原操作使用的 NuGet 配置文件 (nuget.config) 。

--disable-parallel

禁用并行还原多个项目。

--force

强制解析所有依赖项,即使上次还原已成功,也不例外。 指定此标记等同于删除 project.assets.json 文件 。

-h|--help

打印出有关命令的简短帮助。

--ignore-failed-sources

如果存在符合版本要求的包,则源失败时警告。

--no-cache

指定不缓存包和 HTTP 请求。

--no-dependencies

当使用项目到项目 (P2P) 引用还原项目时,还原根项目,不还原引用。

--packages <PACKAGES_DIRECTORY>

指定还原包的目录。

-r|--runtime <RUNTIME_IDENTIFIER>

指定程序包还原的运行时。 这用于还原 .csproj 文件中的 <RuntimeIdentifiers> 标记中未显式列出的运行时的程序包。 有关运行时标识符 (RID) 的列表,请参阅 RID 目录。 通过多次指定此选项提供多个 RID。

-s|--source <SOURCE>

指定要在还原操作期间使用的 NuGet 包源。 此设置会替代 nuget.config 文件中指定的所有源 。 多次指定此选项可以提供多个源。

--verbosity <LEVEL>

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

--interactive

允许命令停止并等待用户输入或操作(例如,完成身份验证)。 从 .NET Core 2.1.400 开始。

.NET Core 1.x

--configfile <FILE>

供还原操作使用的 NuGet 配置文件 (nuget.config) 。

--disable-parallel

禁用并行还原多个项目。

-h|--help

打印出有关命令的简短帮助。

--ignore-failed-sources

如果存在符合版本要求的包,则源失败时警告。

--no-cache

指定不缓存包和 HTTP 请求。

--no-dependencies

当使用项目到项目 (P2P) 引用还原项目时,还原根项目,不还原引用。

--packages <PACKAGES_DIRECTORY>

指定还原包的目录。

-r|--runtime <RUNTIME_IDENTIFIER>

指定程序包还原的运行时。 这用于还原 .csproj 文件中的 <RuntimeIdentifiers> 标记中未显式列出的运行时的程序包。 有关运行时标识符 (RID) 的列表,请参阅 RID 目录。 通过多次指定此选项提供多个 RID。

-s|--source <SOURCE>

指定要在还原操作期间使用的 NuGet 包源。 这会替代 nuget.config 文件中指定的所有源 。 多次指定此选项可以提供多个源。

--verbosity <LEVEL>

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。


示例

还原当前目录中项目的依赖项和工具:

dotnet restore

还原在给定路径中找到的 app1 项目的依赖项和工具:

dotnet restore ~/projects/app1/app1.csproj

通过将提供的文件路径用作源,在当前目录中还原项目的依赖项和工具:

dotnet restore -s c:\packages\mypackages

通过将提供的两个文件路径用作源,在当前目录中还原项目的依赖项和工具:

dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages

还原当前目录中项目的依赖项和工具,并仅显示最少的输出:

dotnet restore --verbosity minimal

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 05/29/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。