Word 2021侧加载Add-in失败问题求助

1. 验证manifest.xml的有效性与正确性 #

• 用Office加载项验证工具校验：安装office-addin-manifest工具（命令：npm install -g office-addin-manifest），执行office-addin-manifest validate 你的manifest.xml，排查XML语法错误、必填字段缺失（如Id、Version、Hosts、SourceLocation等），重点检查修改过的代码段是否破坏了文件结构。
• 确认SourceLocation路径：必须使用完整的UNC网络共享路径（如\\服务器名\共享目录\加载项\index.html），禁止使用相对路径或本地路径。

2. 检查可信目录配置 #

• 重新配置可信目录：进入Word「文件」→「选项」→「信任中心」→「信任中心设置」→「受信任的加载项目录」，删除现有目录后重新添加，确保路径完全匹配（注意UNC路径的斜杠、空格），并勾选「显示在菜单中」。
• 验证目录识别：添加后关闭并重启Word，再次查看共享文件夹加载项列表。

3. 排查网络共享权限问题 #

• 检查共享与NTFS权限：确保当前Windows用户对共享目录拥有读取+执行权限，同时确认NTFS权限（右键文件夹→「属性」→「安全」）也配置了对应权限，避免仅设置共享权限忽略NTFS权限。
• 测试目录访问：打开文件资源管理器，直接输入共享路径（如\\服务器名\共享目录），确认能正常访问并查看manifest.xml及加载项所有文件，无访问拒绝提示。

4. 彻底清理Office缓存与进程 #

• 结束所有Office进程：打开任务管理器，强制结束WINWORD.EXE、OfficeClickToRun.exe等所有Office相关进程。
• 删除Web加载项缓存：手动删除%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\目录下的全部文件，重启Word后再测试。

5. 更新Office版本 #

• 安装最新更新：进入Word「文件」→「账户」→「更新选项」→「立即更新」，安装Office 2021的所有可用补丁，旧版本可能存在侧加载逻辑的bug。

6. 本地侧加载验证 #

• 将加载项文件复制到本地目录，添加该本地目录为可信目录，若能正常显示加载项，说明问题出在网络共享的配置/权限上；若本地仍无法显示，需排查manifest本身或Office全局配置问题。

7. 检查注册表与组策略 #

• 注册表检查：打开注册表编辑器，定位到HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Word\Options，删除可能存在的DisableAddins类禁用键值。
• 组策略检查：运行gpedit.msc，查看「用户配置」→「Administrative Templates」→「Microsoft Office 2016」→「Security Settings」→「Add-in Management」，确保未启用禁用共享文件夹侧加载的策略。

内容的提问来源于stack exchange，提问作者Boland