安装dotnet core 2.1.300后出现DocFx错误

Question

我创建了一个简单的控制台应用程序以及一个简单的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）：加载锁定文件'E：\ Files \ tmp \ docx \时出错docfx_project \ src \ _ obj \ project.assets.json'：对象引用未设置为对象的实例。

稍后在你看到的输出中

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

其他人遇到这个问题？如何生成元数据？

重新创建项目非常简单：

1. 转到dotnet cli工具命令行
2. docfx init
3. cd src
4. dotnet新控制台
5. cd ..
6. docfx

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

Answer 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

在这里您可以看到实施的当前状态：qazxsw poi

所以你的问题的答案是：到目前为止你还不能将docfx用于.net 2.1