如何通过Google Apps Script为Google Sheets单元格部分文本添加下划线？

当然有办法实现！虽然Google Apps Script里的Range类没有直接提供setUnderline(offsetBegin, offsetEnd)这样的方法，但我们可以借助RichTextValue这个工具类来完成单元格内部分文本的下划线设置，这正好匹配你想要的需求。

核心思路 #

Google Sheets的富文本格式功能支持对单元格内的特定文本区间单独设置样式，而RichTextValueBuilder就是GAS中用来构建这种富文本格式的核心工具。我们可以通过它指定文本的起始和结束偏移量，给对应区间的文本添加下划线。

完整代码示例 #

下面是一个可直接运行的脚本，你可以根据自己的需求修改单元格位置和偏移量：

function setPartialTextUnderline() {
  // 获取当前活动表格和目标单元格
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const targetCell = activeSheet.getRange("A1"); // 替换为你的目标单元格地址
  
  // 获取单元格的文本内容（确保转为字符串格式）
  const cellText = targetCell.getValue().toString();
  
  // 1. 创建富文本构建器，基于单元格现有文本
  const richTextBuilder = SpreadsheetApp.newRichTextValue()
    .setText(cellText);
  
  // 2. 创建下划线样式
  const underlineTextStyle = SpreadsheetApp.newTextStyle()
    .setUnderline(true) // 开启下划线
    .build();
  
  // 3. 给指定区间的文本应用下划线（偏移量从0开始，左闭右开）
  // 示例：给第3到第8个字符添加下划线（对应索引2到7）
  richTextBuilder.setTextStyle(2, 7, underlineTextStyle);
  
  // 4. 将构建好的富文本格式应用回单元格
  targetCell.setRichTextValue(richTextBuilder.build());
}

关键细节说明 #

• 偏移量规则：setTextStyle(startOffset, endOffset, style)中的偏移量是从0开始计数的，并且是左闭右开区间。比如示例中的2,7，会对索引为2、3、4、5、6的字符（也就是第3到第7个可见字符）应用样式。
• 保留原有格式：如果目标单元格已经有其他富文本格式，不要直接用newRichTextValue()，而是用targetCell.getRichTextValue().copy()来创建构建器，这样可以保留原有格式，只修改需要的部分：

  const existingRichText = targetCell.getRichTextValue();
  const richTextBuilder = existingRichText.copy();
  

• 为什么之前的方法没用：getDisplayValue()和getValue()只能获取单元格的纯文本内容，无法操作格式；而Google Docs的Text类是针对文档的API，和Google Sheets的格式系统不兼容，所以无法直接复用。

注意事项 #

这个功能依赖Google Sheets的富文本部分格式支持，也就是你提到的“新功能”，目前新版的Google Sheets已经全面支持，所以只要你的表格是在新版编辑器中，脚本就能正常运行。

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