使用Apps Script修改Google表格单元格文本报cell.setValue错误

你遇到的TypeError: cell.setValue is not a function错误根源是：
range.getValues()返回的是存储单元格原始值的二维JavaScript数组，数组里的元素都是字符串、数字这类基础数据类型，不是Google Apps Script里的Range单元格对象，因此不存在setValue()这个实例方法。

function findAndReplace() {
  const range = SpreadsheetApp.getActiveSpreadsheet().getDataRange();
  const values = range.getValues();
  const replacedValues = values.map(function(row) {
    return row.map(function(cell) {
      // 非字符串类型、或者不包含'Shaun'的单元格直接返回原值
      if (typeof cell !== 'string' || cell.indexOf('Shaun') === -1) {
        return cell;
      }
      // 匹配到的单元格直接替换为目标值'Hello'
      return 'Hello';
      // 如果需要保留单元格其他内容、仅替换子串'Shaun'，就用下面这行代替上面的return
      // return cell.replaceAll('Shaun', 'Hello');
    });
  });

  range.setValues(replacedValues);
}

• 移除了错误的cell.setValue()调用：不需要逐单元格操作Range对象，直接修改getValues()拿到的二维数组即可，最后统一用setValues()批量写回表格，执行效率远高于逐单元格调用API操作
• 简化了遍历逻辑：将原有的reduce嵌套遍历改为二维数组map遍历，不需要手动维护数组索引，代码可读性更高
• 兼容两种替换需求：默认逻辑是匹配到包含'Shaun'的单元格后整体替换为'Hello'；如果需要保留单元格其他内容、仅替换其中的'Shaun'子串，把对应行的返回值改为cell.replaceAll('Shaun', 'Hello')即可

内容的提问来源于stack exchange，提问作者Shaun-B