Google Apps Script单元格数值相加异常：parseInt返回#NUM问题求助

核心问题分析 #

• 字符串拼接：单元格值以字符串形式返回时，直接相加会触发字符串拼接而非数值运算。
• #NUM错误：parseInt转换失败（比如单元格含空格、非数字字符，或转换空值/非数字时返回NaN，写入表格就会显示#NUM）。
• 性能隐患：循环内频繁调用getRange()会大幅降低脚本执行效率。

解决方案要点 #

• 安全数值转换：用Number()替代parseInt，它能更好处理带小数的数值，且对空值/非数字会返回0，避免NaN引发错误。
• 批量读取数据：一次性读取所有需要处理的单元格区域数据到数组，减少API调用次数，提升执行速度。
• 修正变量作用域：避免在循环内重复声明全局同名变量，防止变量覆盖。
• 修复语法错误：feuille.activate改为feuille.activate();（缺少函数调用括号）。

修改后的完整代码 #

function Synthese() {
  const feuille = SpreadsheetApp.getActive().getSheetByName('Synthèse Opérations');
  if (!feuille) return; // 防止工作表不存在报错

  feuille.activate();
  feuille.getRange('A2:I10000').clearContent();

  // 批量读取需要处理的列数据（第11到20列，行2到10000）
  const dataRange = feuille.getRange(2, 11, 9999, 10);
  const data = dataRange.getValues();
  
  let j = 0;
  let k = 0;
  let outputRow = 2; // 结果写入的起始行

  for (let i = 0; i < data.length; i++) {
    const currentRow = data[i];
    if (currentRow[0] === "") break; // 第11列（数组索引0）为空则终止循环

    i += j;
    k = j;
    j = 0;

    // 检查下一行是否有相同的第11列值
    if (i + 1 < data.length && currentRow[0] === data[i + 1][0]) {
      // 初始化数值，用Number安全转换
      let Quantite = Number(data[i][4]) || 0; // 第15列（数组索引4）
      let Frais = Number(data[i][6]) || 0;    // 第17列（数组索引6）
      let Valeur = Number(data[i][7]) || 0;   // 第18列（数组索引7）
      let TotalAchat = Number(data[i][8]) || 0; // 第19列（数组索引8）
      let TotalVersements = Number(data[i][9]) || 0; // 第20列（数组索引9）

      // 合并相同第11列值的行
      while (i + j + 1 < data.length && data[i + j][0] === data[i + j + 1][0]) {
        const nextRow = data[i + j + 1];
        // 写入基础信息到结果行
        feuille.getRange(outputRow, 1).setValue(nextRow[0]); // A列：第11列值
        feuille.getRange(outputRow, 2).setValue(nextRow[1]); // B列：第12列值
        feuille.getRange(outputRow, 3).setValue(nextRow[2]); // C列：第13列值
        feuille.getRange(outputRow, 4).setValue(nextRow[3]); // D列：第14列值

        // 更新Frais
        Frais += Number(nextRow[6]) || 0;
        feuille.getRange(outputRow, 6).setValue(Frais);

        // 更新Valeur（Achat场景）
        if (nextRow[5] === "Achat") { // 第16列（数组索引5）
          const nextValeur = Number(nextRow[7]) || 0;
          const nextQuantite = Number(nextRow[4]) || 0;
          Valeur = (Valeur * Quantite + nextValeur * nextQuantite) / (Quantite + nextQuantite);
          feuille.getRange(outputRow, 7).setValue(Valeur);
        } else {
          feuille.getRange(outputRow, 7).setValue(Valeur);
        }

        // 更新Quantite（Vente/Achat场景）
        if (nextRow[5] === "Vente") {
          Quantite -= Number(nextRow[4]) || 0;
        } else {
          Quantite += Number(nextRow[4]) || 0;
        }
        feuille.getRange(outputRow, 5).setValue(Quantite);

        // 更新TotalAchat和TotalVersements
        TotalAchat += Number(nextRow[8]) || 0;
        feuille.getRange(outputRow, 8).setValue(TotalAchat);
        
        TotalVersements += Number(nextRow[9]) || 0;
        feuille.getRange(outputRow, 9).setValue(TotalVersements);

        j++;
      }
      outputRow++;
    } else {
      // 单独行写入结果
      feuille.getRange(outputRow, 1).setValue(currentRow[0]);
      feuille.getRange(outputRow, 2).setValue(currentRow[1]);
      feuille.getRange(outputRow, 3).setValue(currentRow[2]);
      feuille.getRange(outputRow, 4).setValue(currentRow[3]);
      feuille.getRange(outputRow, 5).setValue(Number(currentRow[4]) || 0);
      feuille.getRange(outputRow, 6).setValue(Number(currentRow[6]) || 0);
      feuille.getRange(outputRow, 7).setValue(Number(currentRow[7]) || 0);
      feuille.getRange(outputRow, 8).setValue(Number(currentRow[8]) || 0);
      feuille.getRange(outputRow, 9).setValue(Number(currentRow[9]) || 0);
      outputRow++;
      j = 0;
    }
  }
};

关键修改说明 #

• 批量数据读取：一次性读取第11到20列的所有数据到数组data，避免循环内反复调用getRange，大幅提升执行效率。
• 安全转换逻辑：Number(value) || 0确保即使单元格为空或含非数字内容，也会转换为0，彻底避免NaN导致的#NUM错误。
• 变量作用域优化：移除全局同名变量的重复声明，解决变量覆盖问题。
• 边界检查：添加i + 1 < data.length等判断，防止数组越界报错。
• 索引清晰化：数组索引从0开始，对应原列的索引偏移（如第11列对应数组索引0），逻辑更直观。

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