How can I side load excel addin from xml file in desktop app?

在Office生态系统持续向云端与插件化演进的当下，Excel加载项（Add-ins）已成为提升办公效率的重要工具。对于开发者和高级用户而言，“侧加载”（Sideloading）是一种无需发布至官方商店便能快速测试或内部部署加载项的方法。近期，不少技术社区用户询问：如何通过XML清单文件在桌面版Excel中侧加载加载项？ 本文将结合官方文档与实操经验，为您提供完整的技术指引。

什么是“侧加载”与XML清单？

Office加载项本质上是一个基于Web技术（HTML、CSS、JavaScript）的应用程序，通过一个XML清单文件描述其元数据、图标、功能区域及调用URL。侧加载指将尚未公开注册的加载项手动加载到Office客户端中，常见于开发调试或企业内部分发场景。桌面版Excel（Windows/macOS）均支持此模式，而XML清单则是整个过程的“钥匙”。

准备工作：创建您的XML清单文件

在开始侧加载之前，您需要准备一个有效的清单（Manifest）文件。以下是一个最小化示例（manifest.xml），它定义了一个在任务窗格中打开的加载项：

<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:type="TaskPaneApp">
  <Id>e1a5e7b0-7d3c-4f4a-9f6c-1b2c3d4e5f6a</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Your Company</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="My Excel Add-in" />
  <Description DefaultValue="A custom task pane add-in for Excel."/>
  <Hosts>
    <Host Name="Workbook" />
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://your-server.com/app/home.html" />
  </DefaultSettings>
  <Permissions>ReadWriteDocument</Permissions>
</OfficeApp>

将上述文件保存为XML格式，并将<SourceLocation>中的URL替换为您实际托管的Web应用地址。注意：清单中的<Id>需为全局唯一GUID，不可与其他加载项重复。

桌面版Excel侧加载实操步骤

Windows平台（Excel 2019/365）

共享清单文件：将XML文件放置在本地文件夹或网络共享路径中（例如 C:\Addins\manifest.xml）。
修改注册表（需管理员权限）： - 打开注册表编辑器（regedit）。 - 导航至 HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer\（若路径不存在则手动创建）。 - 在该项下新建一个字符串值（REG_SZ），名称任意（如 MyAddin），数值数据填写清单文件的完整路径（例如 C:\Addins\manifest.xml）。
启动Excel：新建或打开一个工作簿，点击“插入”选项卡，在“加载项”组中选择“获取加载项”，接着点击“我的加载项”选项卡，即可看到您侧加载的加载项，点击插入即可使用。

注意：部分企业环境可能禁用注册表编辑，此时可尝试使用Office部署工具或组策略进行分发。

macOS平台（Excel 2019/365）

macOS的侧加载无需注册表，而是通过用户目录下的特定文件夹实现： 1. 创建文件夹 ~/Library/Containers/com.microsoft.Excel/Data/Documents/wef/（若不存在则手动创建）。 2. 将XML清单文件复制到该文件夹中。 3. 重启Excel，加载项将自动出现在“插入”>“我的加载项”列表中。

常见问题与排错指南

加载项未显示：检查清单文件中的XML格式是否正确（可使用在线校验工具）。确保<Id>唯一且URL可访问（若为本地测试，推荐使用localhost并通过HTTPS服务）。
提示“加载项无法加载”：最常见原因是清单中的SourceLocation指向的URL未使用HTTPS协议（Office强制要求安全连接）。自签名证书可在开发环境使用，但需将证书加入受信任根目录。
注册表修改后未生效：确认Excel版本号。版本号16.0对应Office 2016/2019/365，若使用Office 2013则路径为15.0。推荐以16.0为准。

进阶技巧：从网络位置侧加载

若想在多台电脑上快速部署，可将XML清单放在共享网络文件夹（如 \\server\share\manifest.xml），然后在每台电脑的注册表对应位置添加指向该网络路径的字符串值。注意：需要客户端对该路径有读取权限，且Office需以用户身份访问共享（非系统服务）。

总结与展望

通过XML文件侧加载Excel加载项，是开发者和企业IT管理员实现快速迭代与内部交付的高效手段。其核心逻辑在于：利用清单文件向Office客户端“注册”一个Web应用的入口。随着Microsoft 365平台对定制化解决方案的重视，掌握这一技能将有助于您深入挖掘Office生态的潜力。

如果您是初次尝试，建议从简单的任务窗格加载项开始，逐步熟悉XML清单结构及部署流程。更多官方规范请参考Microsoft Docs的“Office Add-ins manifest”章节。现在，您就可以动手创建自己的第一个Excel插件了！