Microsoft.Office.Core引用歧义致Word加载项发布构建失败求助

问题场景 #

开发Word VSTO加载项时，Debug模式下代码可正常运行，但发布阶段出现引用相关错误。简化代码如下：

Imports Microsoft.Office.Core
Imports Microsoft.Office.Interop.Word

Module Example
    Public Sub AccessAFile()
        Dim wordApp As Application = Globals.ThisAddIn.Application
        Dim fDialog As FileDialog = wordApp.FileDialog(MsoFileDialogType.msoFileDialogFolderPicker)
    End Sub
End Module

报错阶段 #

1. 初始发布报错

Reference required to assembly 'office, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c' containing the type 'FileDialog'. Add one to your project.

2. 添加引用后歧义报错
   手动添加程序集office(15.0.0.0)或COM引用Microsoft Office 16.0 Object Library(2.8)后，出现：

'FileDialog' is ambiguous in the namespace 'Microsoft.Office.Core'.
'MsoFileDialogType' is ambiguous in the namespace 'Microsoft.Office.Core'.

解决方案 #

1. 正确选择引用类型 #

VSTO Word加载项应使用**.NET互操作程序集引用**，而非COM引用。VSTO项目创建时会自动添加Microsoft.Office.Interop.Word和Office（对应Microsoft.Office.Core）的必要引用，手动添加COM引用会导致重复引用，触发歧义错误。

2. 清理重复引用 #

• 移除所有手动添加的COM引用（如Microsoft Office 16.0 Object Library）。
• 移除重复的Office程序集引用，仅保留项目默认生成的那一项。

3. 代码调整（可选） #

若仍存在歧义，可移除Imports Microsoft.Office.Core导入语句，或在代码中显式指定完整命名空间：

Imports Microsoft.Office.Interop.Word

Module Example
    Public Sub AccessAFile()
        Dim wordApp As Application = Globals.ThisAddIn.Application
        Dim fDialog As Microsoft.Office.Core.FileDialog = wordApp.FileDialog(Microsoft.Office.Core.MsoFileDialogType.msoFileDialogFolderPicker)
    End Sub
End Module

4. 引用属性设置 #

针对Office和Microsoft.Office.Interop.Word引用，调整以下属性：

• Embed Interop Types: 设置为True（默认值），将互操作类型嵌入输出程序集，避免发布时依赖外部互操作组件，同时解决版本兼容问题。
• Copy Local: 设置为False，因为Office互操作程序集已预装在目标机器的GAC中，无需复制到输出目录。

5. 验证发布 #

清理项目（Build > Clean Solution），重新生成（Build > Rebuild Solution），再尝试发布。

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