如何用Excel JavaScript API与Angular替换旧版加载项自定义函数语法？

通过Excel JavaScript API结合Angular，完全能够完成旧版自定义公式到新版的替换操作，支持工作簿全局、指定工作表及单个/指定单元格范围三个层面的替换。

实现原理 #

自定义公式本质是单元格的公式文本内容，利用Excel JS API的Range.replace方法，通过文本匹配替换旧公式标识即可完成转换，比如将=OLD.GET(替换为=NEW.GETGD(，保留原公式的参数部分。

1. 工作簿全局替换 #

遍历所有工作表，对每个表的已使用区域执行批量替换：

async replaceOldFormulaInWorkbook(): Promise<void> {
  await Excel.run(async (context) => {
    const sheets = context.workbook.worksheets;
    sheets.load("items");
    await context.sync();

    for (const sheet of sheets.items) {
      const usedRange = sheet.getUsedRange();
      // 匹配旧公式前缀，替换为新版前缀
      usedRange.replace(
        "=OLD.GET(", 
        "=NEW.GETGD(", 
        Excel.ReplaceLookAt.part, 
        false, 
        false, 
        false, 
        false
      );
    }

    await context.sync();
    console.log("工作簿内所有旧公式替换完成");
  });
}

2. 指定工作表替换 #

仅针对特定工作表进行替换：

async replaceOldFormulaInSheet(sheetName: string): Promise<void> {
  await Excel.run(async (context) => {
    const targetSheet = context.workbook.worksheets.getItem(sheetName);
    const usedRange = targetSheet.getUsedRange();
    
    usedRange.replace(
      "=OLD.GET(", 
      "=NEW.GETGD(", 
      Excel.ReplaceLookAt.part, 
      false, 
      false, 
      false, 
      false
    );

    await context.sync();
    console.log(`工作表${sheetName}内旧公式替换完成`);
  });
}

3. 单个/指定单元格范围替换 #

精准替换特定单元格区域内的公式：

async replaceOldFormulaInRange(sheetName: string, rangeAddress: string): Promise<void> {
  await Excel.run(async (context) => {
    const targetSheet = context.workbook.worksheets.getItem(sheetName);
    const targetRange = targetSheet.getRange(rangeAddress);
    
    targetRange.replace(
      "=OLD.GET(", 
      "=NEW.GETGD(", 
      Excel.ReplaceLookAt.part, 
      false, 
      false, 
      false, 
      false
    );

    await context.sync();
    console.log(`区域${rangeAddress}内旧公式替换完成`);
  });
}

注意事项 #

• 匹配规则：使用Excel.ReplaceLookAt.part确保部分匹配，适配参数不固定的自定义公式场景
• 性能优化：若工作簿数据量极大，建议分批次处理工作表或区域，避免卡顿
• 验证备份：替换前务必备份工作簿，或在测试环境验证替换结果，确保公式参数和逻辑不受影响

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