如何发布适配低版本Excel与旧版.NET框架的Excel VSTO项目

核心兼容性前置调整 #

• 不要直接将当前基于.NET Framework 4.8开发的原项目直接发布安装，需要先根据目标设备的环境拆解适配矩阵：
  • 针对搭载Excel 2007的设备：将项目目标框架从.NET Framework 4.8降级到.NET Framework 3.5，配套使用VSTO 2005 SE运行时，代码层面移除所有仅在.NET 4.0及以上版本才支持的API（比如async/await、dynamic类型、扩展的LINQ方法等），避免运行时报错。
  • 针对搭载Excel 2010、2013的设备：将项目目标框架降级到.NET Framework 4.6.2（这是兼容老办公系统的最高稳定4.x框架版本，不需要额外安装高版本Windows补丁），配套使用VSTO 4.0运行时，不需要降级到3.5框架。
• 固定项目编译配置为32位（x86），不要使用AnyCPU配置，避免和老版本32位Excel出现进程位宽不匹配的加载失败问题。
• 将项目引用的Excel互操作程序集替换为对应最低支持版本（Excel 2007的主互操作程序集），不要使用Microsoft 365版本自带的高版本Excel互操作库，防止调用到老版本Excel不存在的COM接口。

离线打包与环境依赖整合 #

• 取消依赖在线环境检测/下载的安装逻辑，把所有需要的安装包统一打包到U盘/共享目录中：
  • 对应Excel2007分支：打包离线版.NET Framework 3.5安装包、VSTO 2005 SE运行时安装包
  • 对应Excel2010/2013分支：打包离线版.NET Framework 4.6.2安装包、VSTO 4.0离线运行时安装包
• 在安装包中加入环境检测逻辑：安装启动时先校验当前设备的.NET版本、VSTO运行时版本、Excel版本，不满足要求时先引导用户安装对应依赖，再执行插件安装流程，避免直接安装插件出现加载失败。

多设备批量安装适配 #

• 放弃默认的ClickOnce Web发布模式，改用本地目录安装脚本适配5-6台设备的规模：
  • 在项目发布设置中，将发布路径设置为本地共享文件夹/U盘目录，关闭自动检查更新选项，避免插件启动时因找不到在线更新源弹出报错。
  • 编写简单批处理安装脚本，实现以下逻辑：
    • 自动识别当前设备的Excel版本，匹配对应框架分支的插件安装包
    • 采用用户级安装方式，将插件文件直接部署到当前用户的Documents\AddIns目录下，同时在HKCU注册表路径下写入VSTO加载项的注册信息——这种方式不需要本地管理员权限，不会因为普通办公设备的权限限制安装失败。
    • 自动将插件安装目录加入Excel的受信任位置列表，避免Excel安全策略拦截插件加载。
• 关闭VSTO项目的强制发布者签名验证，没有商用代码签名证书的情况下，依赖本地受信任位置即可绕过安全警告，不需要额外采购证书。

上线前的验证注意事项 #

• 不要仅在Microsoft 365版Excel中完成测试，需要分别在对应版本的Excel环境下验证自定义列计算的核心功能，确认没有COM对象调用报错。
• 安装完成后在每台目标设备上检查Excel的“加载项”管理页，确认插件被正常识别为“活动应用程序加载项”，没有被自动禁用。

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