如何批量修改Google Sheets单元格中删除线文本的字体颜色？

需求说明 #

仅修改单元格内部分文本的颜色，而非整个单元格字体颜色；遍历指定列，将其中所有带删除线（STRIKETHROUGH）的文本改为灰色。

失败代码示例 #

function changeUnderlineColor() 
{
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("Activity Log"); // 获取目标工作表
  var column = ss.getRangeByName("toDos").getColumn(); // 获取指定命名范围的列号
  var range = sheet.getRange(3, column, sheet.getLastRow(), 1); // 定义要处理的列范围（从第3行开始）
  var values = range.getValues(); // 获取范围值（实际未用到）

  var redColor = SpreadsheetApp.newTextStyle().setForegroundColor("#ff0000").build();
  
  for (var i = 0; i < values.length; i++) {
    var cell = range.getCell(i + 1, 1); // 获取当前行的单元格
    var richTextValue = cell.getRichTextValue(); // 获取单元格的富文本内容
    Logger.log(richTextValue)
    var richText = richTextValue.getRuns(); // 获取富文本中的文本片段
    
    for (var j = 0; j < richText.length; j++) {
      var font = richText[j].getTextStyle(); // 获取当前文本片段的样式
      if (font.isUnderline()) 
      { // 判断是否为下划线（需求是删除线，此处错误）
         // 修改下划线文本颜色为红色（方法错误）
         redColor.setTextStyle(1,2,"red");
         cell.setRichTextValue(redColor);
      }
    }
    cell.setRichTextValue(richTextValue); // 将原富文本内容重新设置回单元格，导致修改失效
  }
}

问题分析 #

1. 样式判断错误：需求是处理删除线文本，但代码中判断的是下划线（isUnderline()），应改为isStrikethrough()。
2. 样式修改逻辑错误：已构建的TextStyle对象不可直接修改，需通过RichTextValueBuilder重新构建单元格的富文本内容，针对每个符合条件的文本片段更新样式。
3. 最终赋值错误：循环结束后将原未修改的richTextValue设置回单元格，导致之前的修改全部失效。

修正后的代码 #

function changeStrikethroughToGray() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("Activity Log");
  const targetColumn = ss.getRangeByName("toDos").getColumn();
  // 定义处理范围：从第3行到最后一行的目标列
  const lastRow = sheet.getLastRow();
  if (lastRow < 3) return; // 无数据时直接退出
  const range = sheet.getRange(3, targetColumn, lastRow - 2, 1);
  
  const grayTextStyle = SpreadsheetApp.newTextStyle()
    .setForegroundColor("#808080") // 设置灰色
    .build();

  const cells = range.getRichTextValues();
  // 遍历每个单元格的富文本内容
  for (let i = 0; i < cells.length; i++) {
    const originalRichText = cells[i][0];
    const runs = originalRichText.getRuns();
    const builder = SpreadsheetApp.newRichTextValue();

    // 遍历每个文本片段，更新符合条件的样式
    runs.forEach(run => {
      const text = run.getText();
      const style = run.getTextStyle();
      // 如果当前片段有删除线，应用灰色样式；否则保留原样式
      if (style.isStrikethrough()) {
        builder.appendText(text).setTextStyle(grayTextStyle);
      } else {
        builder.appendText(text).setTextStyle(style);
      }
    });

    // 将修改后的富文本设置回单元格
    range.getCell(i + 1, 1).setRichTextValue(builder.build());
  }
}

代码说明 #

• 用isStrikethrough()准确判断删除线文本片段
• 通过RichTextValueBuilder逐个处理文本片段，保留原样式的同时替换删除线文本的颜色为灰色
• 避免了原代码中覆盖修改结果的错误，确保修改生效

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