如何调试MS Word加载项？打开VBA编辑器提示“Project is unviewable”

核心原因 #

这个提示意味着加载项的VBA项目被启用了不可查看保护，一般是开发者发布加载项时设置的，用于限制代码的查看和修改权限。

针对自建加载项的解决方法 #

如果加载项是你自己开发的，只是误设了保护，按以下步骤解除：

• 找到加载项的源文件（.dotm/.docm格式），打开后启动VBA编辑器（Alt+F11）
• 右键点击项目名称，选择VBAProject属性
• 切换到保护标签页，取消勾选「锁定项目以查看」，输入设置过的保护密码（如有），保存后重新加载加载项
• 此时即可正常展开项目、设置断点调试

针对第三方加载项的调试思路（无源码权限） #

如果是第三方加载项且无密码，无法直接解除保护，可通过以下方式间接调试：

• 用Word宏录制功能记录加载项的操作流程，生成参考宏代码，以此分析加载项的触发逻辑
• 利用VBA的Application事件（如DocumentOpen、AddinInstall）监控加载项行为，在事件代码中设置断点跟踪运行上下文
• 借助Windows调试工具（如Visual Studio）附加到Word进程，通过反汇编跟踪加载项执行（需具备逆向工程基础）

项目可查看后的调试步骤 #

• 打开空白Word文档，确认加载项已启用
• 启动VBA编辑器，找到加载项项目并展开
• 在目标代码行左侧点击设置断点（显示红色圆点）
• 返回Word界面触发加载项功能（如点击加载项按钮）
• VBA编辑器会自动跳转到断点处，可通过本地窗口查看变量值，立即窗口执行临时代码，用F8单步执行、F5继续运行完成调试

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