安装dotnet核心2.1.300后的DocFx错误

Question

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

18-06-05 05:52:41.715Warning:MetadataCommand.ExtractMetadataWorkspace失败:失败Msbuild在处理文件'E:\Files\tmp\docx\docfx_project\src\src.csproj‘时失败，其消息为: 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’：对象引用未设置为对象的实例。

在后面的输出中可以看到

为src生成18-06-05 05:52:42.467Warning:MetadataCommand.ExtractMetadataNo元数据。

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

重新创建该项目非常简单：

1. goto dotnet cli tools命令行
2. docfx
3. cd src
4. dotnet新控制台
5. cd ..。
6. 多夫克斯

我已经安装和使用了dotnet 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

在这里，您可以看到实现的当前状态：https://github.com/dotnet/docfx/projects/1

因此，您的问题的答案是:到目前为止您还不能在.net 2.1中使用docfx。