VS2019环境下Help Viewer 2.3不显示.Net Core 5.0文档怎么办
问题现象
使用版本为16.9.0的Visual Studio 2019,本地已安装包含5.0.200版本在内的全量.NET Core SDK,但内置版本为2.3的Help Viewer文档分类列表中,不存在.NET Core 5的对应条目,无法查看相关离线帮助内容。
核心根因
Help Viewer 2.3 未适配.NET 5版本的离线文档索引:随VS2019 16.9.0配套发布的Help Viewer 2.3,内置的官方可下载文档目录最高仅覆盖到.NET Core 3.1,不会在本地SDK安装完成后自动关联生成.NET 5的文档分类条目,该问题和本地SDK的安装完整性无关。
实际可操作的解决方法
- 方法1:将当前使用的VS2019 升级至16.11及以上的长期支持维护版本,在Visual Studio Installer的「单个组件」配置页,确认勾选最新版Help Viewer组件后完成更新流程。更新完成后打开Help Viewer的「管理内容」界面,即可在可用文档分类列表中检索到.NET 5的对应离线文档包,选择添加并等待下载完成即可正常浏览内容。
- 方法2:如果受网络、合规等环境限制无法升级VS2019版本,可通过本地能力生成适配文档完成导入:
- 调用本地已安装的5.0.200 SDK自带的CLI工具,生成Help Viewer可识别的
.msha格式离线文档包 - 打开Help Viewer的内容管理面板,选择「从磁盘导入本地内容」选项,选中生成的文档包路径完成导入,即可在文档分类列表中看到对应内容条目
- 调用本地已安装的5.0.200 SDK自带的CLI工具,生成Help Viewer可识别的
- 注意事项:Help Viewer 不会自动扫描本地已安装SDK关联的帮助资源,所有展示的文档条目均依赖官方分发的内容索引文件,缺少对应索引的情况下,即便本地存在相关文档文件,也不会自动在分类列表中展示。
内容的提问来源于stack exchange,提问作者BHP
相关产品推荐
相关产品推荐

