如何在Google Apps Script中用setValues更新行且不覆盖公式？

要实现无需拆分多个范围、仅更新指定单元格同时保留公式的需求，可以通过先获取目标范围的现有公式和值，再针对性替换需要更新的内容来实现，具体步骤如下：

核心思路 #

1. 读取目标行的完整公式数组和值数组，保留所有单元格的原始状态（公式或普通值）
2. 仅替换需要更新的单元格内容，其余位置保留原公式或值
3. 用setFormulas()方法一次性写入更新后的数组（该方法会自动识别公式和普通值：以=开头的字符串作为公式处理，普通字符串/数值直接作为值写入）

代码示例 #

假设你需要更新第1、2、4、5列，保留第3列的公式：

function updateUserInfo(ws, rowNumber, userInfo) {
  // 获取目标行的范围（1行5列）
  const targetRange = ws.getRange(rowNumber, 1, 1, 5);
  
  // 获取现有值数组和公式数组（取第一行，索引为0）
  const existingValues = targetRange.getValues()[0];
  const existingFormulas = targetRange.getFormulas()[0];
  
  // 构建更新后的行数据
  const updatedRow = existingValues.map((val, index) => {
    switch(index) {
      case 0: // 第1列：更新为userInfo.start
        return userInfo.start;
      case 1: // 第2列：更新为userInfo.finish
        return userInfo.finish;
      case 3: // 第4列：更新为userInfo.value1
        return userInfo.value1;
      case 4: // 第5列：更新为userInfo.value2
        return userInfo.value2;
      default: 
        // 其他列：有公式则保留公式，无公式则保留原数值
        return existingFormulas[index] || val;
    }
  });
  
  // 一次性写入更新后的数据，保留公式
  targetRange.setFormulas([updatedRow]);
}

为什么之前的方法无效？ #

• getFormula()仅返回单个单元格的公式，无法获取整行的公式分布，无法批量处理
• getDisplayValues()返回的是单元格的显示结果（比如公式计算后的数值），不是原始公式或输入值，无法用于保留公式

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