替代帮助查看器默认值

可以在 Visual Studio IDE 中更改Microsoft帮助查看器和帮助相关功能的默认行为。

帮助内容管理器是一种可用于部署和管理本地帮助查看器内容的工具。 若要更改帮助查看器的行为,可以通过更改帮助内容管理器 (HlpCtntMgr.exe) 的默认设置来实现。

可通过不同的方式设置帮助内容管理器选项:

  • 创建 . pkgdef 文件 以设置注册表项值。
  • 直接在注册表中设置选项。

使用 .pkgdef 文件更改帮助查看器行为

.pkgdef 文件存储帮助查看器使用的配置信息。 可以使用 .pkgdef 文件调整下表列出了的注册表项值:

注册表项值 类型 Data Description
新内容和更新服务 字符串 <服务终结点 URL> 定义唯一的服务终结点
使用在线帮助 dword 0 若要指定本地帮助, 1 则指定联机帮助 定义联机或脱机帮助默认值
OnlineBaseUrl 字符串 <服务终结点 URL> 定义唯一的 F1 终结点
在线帮助偏好已禁用 dword 0启用或1禁用联机帮助首选项 禁用联机帮助首选项
禁用内容管理 dword 0在帮助查看器中启用或禁用1“管理内容”选项卡 禁用 “管理内容 ”选项卡
禁用首次运行帮助选择 dword 0 1启用或禁用首次启动 Visual Studio 时配置的帮助功能 在 Visual Studio 首次启动时禁用内容安装

若要在 .pkgdef 文件中设置注册表项值,请执行以下步骤:

  1. 创建新文件,并为其指定扩展名 .pkgdef

  2. 将以下文本添加到文件的第一行:

    [$RootKey$\Help]

  3. 在单独的行上,添加上表描述的任何注册表项值。 例如,可以添加此行来配置 UseOnlineHelp 值:

    "UseOnlineHelp"=dword:00000001

  4. 将文件复制到安装 Visual Studio 的 CommonExtensions 文件夹中。 例如:

    • 如果使用 Visual Studio 2017 社区版,请将 .pkgdef 文件添加到此文件夹:

      C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • 如果使用 Visual Studio 2022 社区版,请将 .pkgdef 文件添加到此文件夹:

      C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. 在开发人员命令提示符处运行以下命令:

    devenv /updateconfiguration

示例 .pkgdef 文件内容

[$RootKey$\Help]
"NewContentAndUpdateService"="https://some.service.endpoint"
"UseOnlineHelp"=dword:00000001
"OnlineBaseUrl"="https://some.service.endpoint"
"OnlineHelpPreferenceDisabled"=dword:00000000
"DisableManageContent"=dword:00000000
"DisableFirstRunHelpSelection"=dword:00000001

使用注册表编辑器更改帮助查看器行为

可以通过在注册表编辑器中设置注册表项值来控制以下类型的行为。

任务 注册表项 价值 Data
替代 BITS 作业优先级 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node(在 64 位计算机上)\Microsoft\Help\v2.3 BITS优先级 前景正常
指向于网络共享上的本地内容存储库 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 位置路径 ContentStoreNetworkShare