如何仅通过Google Script实现Google Sheet条件格式及奖学金资格判定

Hi there! 作为刚学Google Script的学生，咱们一步步来拆解你需要的功能，给你关键的规则和代码指引，而不是直接丢完整代码给你～

1. 添加"eligibility"表头列 #

首先要搞定新列的添加，核心是操作Google Sheet的工作表对象：

• 先获取目标工作表：用SpreadsheetApp.getActiveSpreadsheet()获取当前打开的表格，再用getSheetByName("你的工作表名称")指定具体表（如果用当前激活的表，就用getActiveSheet()）。比如：

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("学生数据");
  

• 添加新列的两种常用方式：
  • 直接在表格末尾添加列并设置表头：用sheet.appendColumn("eligibility")，一行代码搞定。
  • 在指定位置插入列：比如想在第3列后面插入，就用sheet.insertColumnAfter(3)，然后再用sheet.getRange(1, 4).setValue("eligibility")设置表头（注意行、列索引都是从1开始的）。

2. 实现资格判定的核心逻辑 #

这部分的核心是批量读写数据（比逐个单元格操作高效太多），拆解为几个关键步骤：

• 第一步：获取数据范围
  先拿到所有包含出勤率、收入数据的行（跳过第1行表头）。用sheet.getLastRow()获取表格最后一行的行号，计算出数据行数：const dataRowCount = sheet.getLastRow() - 1;
• 第二步：读取数据到数组
  用getValues()把数据区域读成二维数组（每行是一个子数组，每个元素对应单元格值）。比如假设出勤率在第2列、收入在第3列，就可以这样获取：

  const dataRange = sheet.getRange(2, 1, dataRowCount, 3); // 从第2行第1列开始，取dataRowCount行，3列数据
  const data = dataRange.getValues();
  

• 第三步：遍历数组应用判定规则
  循环每一行数据，取出出勤率和收入值，判断是否满足条件：
  • 注意：如果出勤率是百分比格式（比如单元格显示85%，实际存储的是0.85），直接和0.8比较就行；如果是带百分号的字符串（比如"85%"），需要先转成数值：parseInt(row[1].replace("%", "")) / 100（假设出勤率在数组的第2个元素，索引是1）
  • 判定逻辑的伪代码框架：

    const results = [];
    for (const row of data) {
      const attendanceRate = row[1]; // 替换成你实际的出勤率列索引
      const income = row[2]; // 替换成你实际的收入列索引
      let eligibilityStatus;
      if (attendanceRate > 0.8 && income < 30000) {
        eligibilityStatus = "符合资格";
      } else {
        eligibilityStatus = "不符合资格";
      }
      results.push([eligibilityStatus]); // 要转成二维数组，方便后续写入
    }
    

• 第四步：把结果写回表格
  找到eligibility列的位置（比如是第4列），用setValues()批量写入结果：

  sheet.getRange(2, 4, results.length, 1).setValues(results);
  

3. 关键注意事项 #

• 效率优先：一定要用getValues()和setValues()批量处理，别在循环里用getValue()/setValue()逐个操作，否则数据多的时候脚本会跑得特别慢。
• 索引确认：务必搞清楚出勤率、收入、eligibility列对应的索引（从1开始），别搞混了导致逻辑错误。
• 小范围测试：先拿3-5行数据测试脚本，确认逻辑正确后再处理整个表格。
• 权限授权：第一次运行脚本时，Google会要求授权，按照提示完成即可（这是正常的安全流程）。

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