『.NET Core CLI工具文档』（八）dotnet-restore

说明：本文是个人翻译文章，由于个人水平有限，有不对的地方请大家帮忙更正。
原文：dotnet-restore
翻译：dotnet-restore

名称

dotnet-restore - 还原一个项目的依赖项和工具

概要

dotnet restore [--source] [--packages] [--disable-parallel] [--fallbacksource] [--configfile] [--verbosity] [<root>]

描述

dotnet restore 命令使用 NuGet 还原在 project.json 文件中被指定的依赖项，以及项目特定工具。
默认情况下，依赖项和工具的还原是并行完成的。

为了还原依赖项，需要提供 NeGet 包所在位置的源。
源通常是通过 NuGet.config 配置文件提供的；安装了 CLI 工具时默认存在一个。
你可以通过在项目目录中创建自己的 NuGet.config 文件指定更多的源。
源也可以在每次调用命令行上指定。

对于依赖项，你可以在还原操作时使用 --packages 参数指定还原包的位置。
如果没有指定，默认使用 NuGet 包缓存。
它存在所有的操作系统上的用户目录下的 .nuget/packages 目录中（例如，Linux 上的 /home/user1 或者是 Windows 上的 C:\Users\user1）。

对于项目特定的工具，dotnet restore 首先还原该工具打包的包，然后继续还原在 project.json 中指定的工具依赖项。

选项

[root]

还原的项目或者项目目录的列表。该列表可以是包含一个 project.json 文件的路径，或者一个 global.json 文件或文件夹的路径中的一个。还原操作递归运行所有子目录，并还原找到的每个给定的 project.json 文件。

-s, --source [SOURCE]

指定一个在还原操作期间使用的源。这覆盖所有在 NuGet.config 文件中指定的源。多个源可以通过指定此选项多次来提供。

--packages [DIR]

指定要放置还原的包的目录。

--disable-parallel

禁用并还原多个项目。

-f, --fallbacksource [FEED]

当在还原操作如果其它所有源不能使用的情况下指定一个备用来源。所有有效的源格式都是允许的。多个备用源可以通过指定此选项多次来提供。

--configfile [FILE]

用于还原操作的配置文件（NuGet.config）。

--verbosity [LEVEL]

使用日志详细级别。允许的值：Debug、 Verbose、 Information、Minimal、Warning 或者 Error。

例子

dotnet restore

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

dotnet restore ~/projects/app1/project.json

还原在给定的路径发现 app1 项目依赖项和工具。

dotnet restore -f c:\packages\mypackages

还原在当前目录中的项目的依赖项和工具，使用文件路径作为备用源。

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

还原在当前目录中的项目的依赖项和工具，使用两个文件路径作为备用源。

dotnet restore --verbosity Error

还原在当前目录中的项目的依赖项和工具，并在输出中仅显示 errors。