如何在Google Apps Script中基于.getValues()设置单元格条件格式？

你已经完成了核心的逻辑判断，要给符合条件的行应用格式，关键是通过数组索引定位到表格中的实际行范围——getValues()仅返回单元格值，无法直接操作格式，需要借助getRange()方法获取对应单元格的Range对象，再调用格式设置方法。

以下是修改后的完整代码，以设置背景色和字体颜色为例，你可以根据需求调整格式：

function updateFormatting() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getRange("C2:I37");
  const cellValues = dataRange.getValues();
  const totalRows = cellValues.length;
  
  // 先重置所有目标行的格式，避免之前的格式残留
  dataRange.setBackground(null).setFontColor(null);

  for (let i = 0; i < totalRows; i++) {
    let rowTotal = 0;
    // 计算当前行复选框选中的总和
    for (let j = 0; j < cellValues[i].length; j++) {
      rowTotal += cellValues[i][j];
    }

    if (rowTotal === 0) {
      // 数组索引i对应表格的第i+2行（数据从第2行开始）
      // 获取当前行的C到I列范围，若要格式化整行，可改为sheet.getRange(i+2, 1, 1, sheet.getLastColumn())
      const targetRange = sheet.getRange(i + 2, 3, 1, 7);
      // 应用自定义格式：示例为灰色背景+浅灰字体
      targetRange.setBackground("#f0f0f0").setFontColor("#666666");
    }
  }
}

关键要点： #

• 行号映射：数组索引从0开始，而你的数据起始于表格第2行，所以数组第i项对应表格的i+2行。
• 范围定位：getRange(起始行, 起始列, 行数, 列数)中，C列对应第3列，C到I共7列，所以参数为(i+2, 3, 1, 7)；若需格式化整行，将最后一个参数改为sheet.getLastColumn()即可。
• 常用格式方法：
  • setBackground(color)：设置单元格背景色
  • setFontColor(color)：设置字体颜色
  • setFontWeight("bold")：设置粗体
  • setBorder(true, true, true, true, false, false)：设置单元格边框
  • 更多格式方法可查阅Google Apps Script官方文档。

优化提示：先统一重置目标范围的格式，再对符合条件的行应用新格式，能减少单元格操作次数，提升脚本运行效率。

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