如何在VSTO Word插件项目中添加自定义注册表项？

阿华AIGC实验室

2026-5-13

解决VSTO Word插件添加自定义注册表项的问题

我来帮你搞定这个问题！先给你理清楚现有注册表项的生成逻辑，再告诉你几种能和默认项同步创建自定义项的可行方案：

一、默认注册表项的生成逻辑

你看到的那4个核心注册表项，是Visual Studio的VSTO项目模板自动生成的：

这些是Office加载插件必须的配置项：比如Manifest指定插件部署文件的路径，LoadBehavior控制插件的加载模式（3代表随Office启动自动加载），FriendlyName和Description是插件在Office中的显示信息。
Visual Studio会根据你当前的构建配置（Debug/Release）自动填充这些项的值，比如Manifest路径会自动指向构建输出目录下的vsto文件。

二、添加自定义注册表项的3种实用方法

方法1：修改项目的注册表模板（推荐，和默认项同步生成）

这是最直接的方式，让自定义项和默认项一起在构建时自动写入注册表：

打开你的VSTO项目，找到Properties文件夹下的Registry节点（如果没有，右键项目→添加→新建项→搜索“注册表项”并添加）。
在注册表编辑器中，导航到目标路径：HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\My.Registry。
右键这个节点，选择新建，根据需求选择字符串值、DWORD值等：
- 比如新建一个REG_SZ类型的键，命名为MyCustomConfig，设置数据为MyCustomValue。
保存后，下次构建项目时，Visual Studio会自动把这个自定义项和默认的4个项一起写入注册表。

方法2：使用Post-Build事件脚本

如果不想修改项目的注册表模板，可以用构建后脚本自动添加自定义项：

右键项目→属性→生成事件→编辑Post-build事件命令行。
输入reg add命令来添加自定义项，示例代码：
```
reg add "HKCU\Software\Microsoft\Office\Word\Addins\My.Registry" /v MyCustomKey /t REG_SZ /d "MyCustomData" /f
```
参数说明：
- /v：指定要添加的键名
- /t：指定键的类型（比如REG_SZ、REG_DWORD）
- /d：键对应的数据
- /f：强制覆盖已存在的键（避免构建时报错）
点击确定后，每次构建完成，这个脚本会自动执行，把自定义项添加到目标路径。

方法3：在插件代码中动态添加（备选方案）

如果需要在插件运行时动态添加注册表项，可以在插件启动事件中编写代码：

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    // 打开目标注册表项
    using (var addinKey = Microsoft.Win32.Registry.CurrentUser.CreateSubKey(@"Software\Microsoft\Office\Word\Addins\My.Registry"))
    {
        // 添加字符串类型的自定义项
        addinKey.SetValue("MyDynamicSetting", "DynamicValue", Microsoft.Win32.RegistryValueKind.String);
        // 添加DWORD类型的自定义项
        addinKey.SetValue("MyDynamicDWORD", 456, Microsoft.Win32.RegistryValueKind.DWord);
    }
}

⚠️ 注意：这种方法只有当插件被Office加载时才会执行，且需要确保当前用户有注册表写入权限，不如前两种方法在构建时添加可靠。