如何通过Office JS检测特定COM版Excel加载项是否已安装？

算力阿峰

2026-8-8

解决方案：JS Excel加载项检测COM加载项并自动隐藏/禁用

核心逻辑

可以通过Excel JavaScript API结合Windows平台的注册表检测实现需求，具体步骤如下：

实现步骤

1. 判断运行平台

先确认加载项是否运行在Windows系统，Mac端直接跳过检测逻辑：

async function isWindows() {
  const platform = await Office.context.platform;
  return platform === Office.PlatformType.PC;
}

2. 检测目标COM加载项是否安装

Windows系统中，COM加载项的配置信息存储在注册表中，可通过自定义逻辑读取对应路径的注册表项来判断是否安装：

async function checkCOMAddin(progId) {
  if (!(await isWindows())) return false;
  
  try {
    // 替换为你的COM加载项ProgID对应的注册表路径
    const regPath = `HKCU\\Software\\Microsoft\\Office\\Excel\\Addins\\${progId}`;
    // 实际需通过VBA桥接、PowerShell调用等方式读取注册表值
    const isInstalled = await readRegistryValue(regPath);
    return isInstalled;
  } catch (err) {
    return false;
  }
}

3. 隐藏/禁用JS加载项

检测到COM加载项存在后，立即隐藏任务窗格并禁用加载项功能：

async function adjustAddinState() {
  // 替换为你的COM加载项实际ProgID
  const targetProgId = "YourCOMAddin.YourProgID";
  const hasCOMAddin = await checkCOMAddin(targetProgId);
  
  if (hasCOMAddin) {
    // 隐藏任务窗格
    await Office.context.ui.hideTaskpane();
    // 禁用所有JS加载项的功能按钮
    disableAddinCommands();
  }
}

function disableAddinCommands() {
  // 根据你的加载项命令ID，遍历设置禁用状态
}