如何用Google Apps Script的TextFinder批量替换A1值为A2值

要实现将所有出现单元格A1值的内容替换为A2的值，同时支持批量处理多个工作表/电子表格，你需要修正两个核心问题：正确获取单元格的实际值、确保TextFinder能匹配单元格内的部分内容。以下是具体实现：

情况1：批量处理当前电子表格中的所有工作表 #

function batchReplaceInSheets() {
  // 获取当前打开的电子表格
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // 获取所有工作表
  const sheets = ss.getSheets();

  sheets.forEach(sheet => {
    // 获取A1和A2单元格的实际值，转为字符串确保匹配兼容性
    const targetText = sheet.getRange('A1').getValue().toString();
    const replaceText = sheet.getRange('A2').getValue().toString();

    // 如果目标替换文本为空，跳过当前工作表
    if (!targetText) return;

    // 定义需要替换的范围（这里是整个工作表，可自定义为特定列如C:D）
    const lastRow = sheet.getLastRow();
    const lastCol = sheet.getLastColumn();
    const targetRange = sheet.getRange(1, 1, lastRow, lastCol);

    // 执行替换，matchEntireCell(false)允许替换单元格内的部分内容
    targetRange.createTextFinder(targetText)
      .matchEntireCell(false)
      .replaceAllWith(replaceText);
  });
}

情况2：批量处理多个独立的电子表格 #

如果需要操作不同的电子表格，可通过表格ID列表实现：

function batchReplaceInSpreadsheets() {
  // 填写需要处理的电子表格ID列表
  const spreadsheetIds = ['表格ID1', '表格ID2', '表格ID3'];

  spreadsheetIds.forEach(id => {
    try {
      const ss = SpreadsheetApp.openById(id);
      const sheets = ss.getSheets();

      sheets.forEach(sheet => {
        const targetText = sheet.getRange('A1').getValue().toString();
        const replaceText = sheet.getRange('A2').getValue().toString();

        if (!targetText) return;

        const lastRow = sheet.getLastRow();
        const lastCol = sheet.getLastColumn();
        const targetRange = sheet.getRange(1, 1, lastRow, lastCol);

        targetRange.createTextFinder(targetText)
          .matchEntireCell(false)
          .replaceAllWith(replaceText);
      });
    } catch (e) {
      // 捕获权限或表格不存在的错误
      console.log(`处理表格ID ${id} 时出错: ${e.message}`);
    }
  });
}

关键说明 #

• 正确获取单元格值：通过getRange('A1').getValue()获取单元格的实际内容，而非直接使用字符串'A1'，转换为字符串是为了兼容不同数据类型的匹配。
• 部分内容替换：matchEntireCell(false)是核心配置，它允许TextFinder匹配单元格内的部分文本，而非仅完全匹配整个单元格内容。
• 范围自定义：如果只需替换特定列（比如原代码中的C:D），可将targetRange改为sheet.getRange(1, 3, lastRow, 2)（对应第3到第4列，即C至D）。

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