安装 dotnet core 2.1.300 后出现 DocFx 错误

Question

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

[18-06-05 05:52:41.715]警告：MetadataCommand.ExtractMetadataWorkspace 失败：[失败] Msbuild 在处理文件 'E:\Files\tmp\docx\docfx_project\src\src.csproj' 时失败，消息为：C:\Program Files\dotnet\sdk.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 生成元数据。

还有其他人运行遇到这个问题吗？我怎样才能生成元数据？

重新创建项目非常简单：

转到 dotnet cli 工具命令行
docfx 初始化
cd 源码
dotnet 新控制台
CD ..
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

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

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

安装 dotnet core 2.1.300 后出现 DocFx 错误

DocFx Error after installing dotnet core 2.1.300

.net-core

docfx