Google Sheets脚本实现查找文本后替换整个单元格值的方法

你原有脚本的问题出在两个地方：

• matchEntireCell(true)的生效规则是单元格完整内容和搜索文本完全一致才会触发替换，你传入的搜索词是纯国家代码（比如US），而实际单元格内容是带指标前缀的sessions US，根本满足不了整格匹配条件，配置实际未生效，最终只替换了单元格内的国家代码片段，保留了前面的指标文本
• 逐段复制TextFinder代码块的方式维护成本高，新增国家规则需要重复写大量重复逻辑

把原有测试脚本替换成下面的代码即可，已经统一封装了国家映射配置，同时实现了整格内容替换：

function replaceColumnHeaders() {
  // 在这里统一配置国家代码和对应全称，新增规则直接加键值对即可
  const countryMap = {
    'US': 'United States of America',
    'IT': 'Italy',
    'CA': 'Canada',
    'GB': 'United Kingdom',
    'JP': 'Japan'
    // 按上面格式继续追加规则即可
  };

  const target = SpreadsheetApp.getActive();

  // 遍历所有配置的国家规则批量替换
  Object.entries(countryMap).forEach(([countryCode, fullName]) => {
    // 正则匹配：任意内容开头，结尾为[空格+国家代码]，完全匹配「指标文本+国家代码」的列头格式
    const searchPattern = `.*\\s${countryCode}$`;
    target.createTextFinder(searchPattern)
      .matchEntireCell(true)
      .matchCase(true)
      .matchFormulaText(false)
      .ignoreDiacritics(false)
      .useRegularExpression(true) // 开启正则匹配，实现整格命中后全量替换
      .replaceAllWith(fullName);
  });
}

• 新增替换规则不需要复制整段TextFinder逻辑，直接在countryMap对象里添加'国家代码': '国家全称'格式的键值对即可
• 如果不需要对整个表格生效，只想替换指定表头行（比如第一行），可以把const target = SpreadsheetApp.getActive();改成对应范围，比如const target = SpreadsheetApp.getActiveSheet().getRange('1:1');，后续替换逻辑会自动限定在指定范围内执行
• 如果你的数据源里指标文本和国家代码之间不是空格分隔（比如是下划线、短横线），把正则里的\\s替换成对应分隔符即可，例如下划线分隔就改成.*_${countryCode}$

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