安装 dotnet core 2.1.300 后出现 DocFx 错误答案

【问题标题】：DocFx Error after installing dotnet core 2.1.300安装 dotnet core 2.1.300 后出现 DocFx 错误
【发布时间】：2018-06-05 18:00:37
【问题描述】：

我创建了一个简单的控制台应用程序以及一个简单的docfx 项目。当我运行 DocFX 命令生成文档时，我收到以下元数据警告，因为该警告导致文档未生成。

[18-06-05 05:52:41.715]警告：MetadataCommand.ExtractMetadataWorkspace 失败：[失败] 处理文件“E:\Files\tmp\docx\docfx_project\src\src.csproj”时，Msbuild 失败带有消息：C:\Program Files\dotnet\sdk\2.1.300\Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets: (198, 5): Error loading lock file 'E:\Files\tmp \docx\docfx_project\src\obj\project.assets.json' : 对象引用未设置为对象的实例。

稍后在您看到的输出中

[18-06-05 05:52:42.467]警告：[MetadataCommand.ExtractMetadata]没有为 src 生成元数据。

还有其他人遇到过这个问题吗？如何获取要生成的元数据？

重新创建项目非常简单：

转到 dotnet cli 工具命令行
docfx 初始化
cd 源代码
dotnet 新控制台
cd ..
docfx

我已经安装并使用了 dotnet sdk 2.1.300

【问题讨论】：

标签： .net-core docfx

【解决方案1】：

在 .net 2.1 中，工具的使用发生了重大变化，现在可以像这样在全球范围内安装和使用这些工具：

dotnet watch
dotnet user-secrets
dotnet sql-cache
dotnet dev-certs

docfx 的开发人员目前正在开发一个支持 .net 2.1 (docfx v3) 的版本：https://github.com/dotnet/docfx/pull/2829

在这里你可以看到当前的执行状态：https://github.com/dotnet/docfx/projects/1

因此，您的问题的答案是：到目前为止，您还不能将 docfx 与 .net 2.1 一起使用

【讨论】：