.NET 4.8升级至.NET 8.0后Microsoft.Office.Interop关键字无法识别

可能的原因及解决步骤 #

1. COM引用互操作嵌入配置缺失 #

.NET Core/.NET 5+对COM引用的处理和.NET Framework差异明显：

• .NET Framework会自动嵌入互操作类型信息，但.NET Core需要显式配置。检查COM引用的属性，确保Embed Interop Types设置为True，这样编译器会嵌入所需类型元数据，避免未识别的关键字。
• 若手动生成互操作程序集，使用tlbimp.exe时要确保生成的程序集与Office版本匹配，且正确引入项目。

2. 命名空间/类型别名冲突 #

.NET 8部分内置命名空间或类型可能与Office COM类型重名（如Range、Document），导致编译器无法识别：

• 调用Office类型时添加完整命名空间前缀，例如Microsoft.Office.Interop.Word.Document而非直接Document；
• 或在COM引用属性中设置Aliases，代码里通过extern alias声明别名来区分冲突类型。

3. .NET Core COM互操作特性变更 #

微软在.NET Core/.NET 5+中对COM互操作做了兼容性调整：

• 若原代码大量使用dynamic操作Office对象，需改为强类型调用，或在项目文件（.csproj）中添加配置启用COM互支持：

<PropertyGroup>
  <EnableComInteropSupport>true</EnableComInteropSupport>
</PropertyGroup>

• .NET Core不支持.NET Framework部分老旧COM互操作特性，需排查代码中是否依赖此类特性。

4. COM引用版本与实际Office不匹配 #

你提到的COM引用版本（8.7、1.9）大概率与当前安装的Office版本不匹配（例如Office 2016+对应的互操作版本应为16.0），版本错位会导致类型/成员无法识别：

• 删除现有COM引用，通过添加引用 -> COM找到对应Office版本的类型库（如Microsoft Word 16.0 Object Library）重新添加，确保版本完全匹配。

5. 项目缓存或目标框架配置问题 #

• 确认项目目标框架正确设置为.NET 8.0，无混合框架引用；
• 清理项目的bin/obj目录，重新生成解决方案，避免旧缓存干扰。

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