如何私下安装Office.js开发的Excel加载项?无需发布至Office商店
Excel加载项内部分发与手动加载问题解答
一、能否不公开发布至Office商店进行内部分发?
完全可以,微软提供了多种无需上架官方商店的内部分发方案:
- 共享文件夹部署:将
manifest.xml放在团队可访问的网络共享文件夹或本地目录,成员通过Excel「我的加载项」→「浏览」选择该文件完成安装。 - Office 365管理员集中部署:管理员通过Microsoft 365管理中心,将加载项定向部署给指定用户/组,成员无需手动操作即可获取。
- 手动侧加载:适合小范围测试场景,直接加载本地
manifest.xml文件。
二、私下安装加载项的限制与注意事项
- Office版本限制:仅支持Office 2016及以上版本,且需为订阅版(Office 365)或零售版,批量许可版可能需额外配置才能加载非商店加载项。
- HTTPS强制要求:生产环境下,加载项的网页资源(html/css/js)必须部署在HTTPS服务器上;本地开发可使用
localhost例外,但内部分发时不能用HTTP协议。 - manifest有效性:文件必须严格符合Office加载项的Schema规范,任何语法错误都会导致加载失败。
- 权限范围约束:加载项请求的权限(如读写工作簿、访问用户信息)需与实际需求匹配,过高权限可能被Office拦截。
- 无自动更新机制:非商店部署的加载项不会自动推送更新,需手动替换
manifest或网页资源,或自行实现更新逻辑。 - 安全风险:内部分发的加载项不受微软商店审核,需确保代码来源可信,避免恶意代码混入。
三、手动加载manifest未出现在列表中的排查步骤
- 确认Office版本与开发模式:打开Excel→「文件」→「账户」,版本号需≥16.0.6741.2017(Office 2016);同时在「文件」→「选项」→「自定义功能区」勾选「开发工具」,在开发工具选项卡中启用「开发人员模式」。
- 验证manifest关键节点:检查以下核心配置是否正确:
Id:必须是唯一的GUID格式Version:需符合x.x.x.x版本格式Hosts:必须包含Workbook节点(对应Excel宿主)DefaultSettings.SourceLocation:指向的网页资源路径正确(本地路径需用file:///开头,网络路径需为HTTPS)
- 检查文件路径:
manifest.xml的存储路径不能包含特殊字符(如中文、空格、感叹号),路径长度不能超过系统限制。 - 清除Office缓存:关闭所有Office程序,删除缓存文件夹:
- Windows:
%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\ - Mac:
~/Library/Containers/com.microsoft.Excel/Data/Library/Application Support/Microsoft/Office/16.0/Wef/
- Windows:
- 检查加载项禁用状态:打开Excel→「文件」→「选项」→「加载项」,在「禁用项目」中查看是否有目标加载项,若有则启用。
- 用官方工具验证manifest:使用Office加载项manifest验证工具检查文件是否符合规范,修复所有报错项。
内容的提问来源于stack exchange,提问作者Eduardo Rangel




