Google Apps Script生成的柱状图图例缺失标题的问题咨询

看起来你遇到的问题是Google Sheets Charts没有正确识别数据系列的表头作为图例标签——虽然你已经设置了useFirstRowAsHeaders: true，但图例依然只显示颜色块而没有系列名称。这个问题通常和自动识别逻辑的优先级或数据范围处理有关，我给你几个可行的解决方案：

方案一：显式指定每个数据系列的图例标签（最稳妥） #

自动识别表头偶尔会因为选项顺序、范围组合等原因失效，我们可以手动从数据范围的第一行提取系列名称，然后强制设置给每个系列：

修改你的buildChart函数，添加提取表头并设置系列标签的逻辑：

function buildChart(title, fullRangeA1, anchorCell) {
  const range = sheet.getRange(fullRangeA1);
  // 从数据范围第一行提取系列名称（跳过第一列的年份列）
  const seriesLabels = range.getValues()[0].slice(1);
  
  const chart = sheet.newChart()
    .asColumnChart()
    .setTitle(title)
    .addRange(range)
    .setPosition(anchorCell.getRow(), anchorCell.getColumn(), 0, 0)
    .setOption("legend", { position: "top" })
    .setOption("hAxis", { title: "Year" })
    .setOption("vAxis", { title: title.includes('%') ? 'Change (%)' : 'Change ($)' })
    .setOption("isStacked", true)
    .setOption("useFirstRowAsHeaders", true)
    .setOption("useFirstColumnAsDomain", true);

  // 为每个数据系列绑定图例标签
  seriesLabels.forEach((label, index) => {
    chart.setOption(`series.${index}.labelInLegend`, label);
  });

  sheet.insertChart(chart.build());
}

方案二：调整选项设置顺序 #

有时候useFirstRowAsHeaders的生效会被后续选项覆盖，你可以尝试把表头识别的设置提前到addRange之后：

function buildChart(title, fullRangeA1, anchorCell) {
  const chart = sheet.newChart()
    .asColumnChart()
    .setTitle(title)
    .addRange(sheet.getRange(fullRangeA1))
    // 优先设置表头和域列的识别规则
    .setOption("useFirstRowAsHeaders", true)
    .setOption("useFirstColumnAsDomain", true)
    // 再设置其他图表选项
    .setPosition(anchorCell.getRow(), anchorCell.getColumn(), 0, 0)
    .setOption("legend", { position: "top" })
    .setOption("hAxis", { title: "Year" })
    .setOption("vAxis", { title: title.includes('%') ? 'Change (%)' : 'Change ($)' })
    .setOption("isStacked", true)
    .build();
  sheet.insertChart(chart);
}

方案三：拆分数据范围添加（备选） #

如果自动识别仍有问题，可以尝试拆分表头和数据范围分别添加到图表中：

function buildChart(title, fullRangeA1, anchorCell) {
  const fullRange = sheet.getRange(fullRangeA1);
  // 单独提取表头行和数据行的范围
  const headerRange = fullRange.offset(0, 0, 1, fullRange.getNumColumns());
  const dataRange = fullRange.offset(1, 0, fullRange.getNumRows()-1, fullRange.getNumColumns());

  const chart = sheet.newChart()
    .asColumnChart()
    .setTitle(title)
    .addRange(headerRange)
    .addRange(dataRange)
    .setPosition(anchorCell.getRow(), anchorCell.getColumn(), 0, 0)
    .setOption("legend", { position: "top" })
    .setOption("hAxis", { title: "Year" })
    .setOption("vAxis", { title: title.includes('%') ? 'Change (%)' : 'Change ($)' })
    .setOption("isStacked", true)
    .setOption("useFirstRowAsHeaders", true)
    .setOption("useFirstColumnAsDomain", true)
    .build();
  sheet.insertChart(chart);
}

关键排查点 #

1. 验证数据本身：先手动在Google Sheets中插入相同范围的柱状图，确认图例是否正常显示——如果手动插入也有问题，说明数据范围的第一行有空单元格、合并单元格或格式异常
2. 检查标题冲突：确保你的表头名称没有被其他脚本或格式设置修改
3. 测试单系列：可以先只保留一个数据系列测试，排查是否是多系列叠加导致的识别问题

优先推荐方案一，它绕过了自动识别的潜在问题，直接强制设置图例显示的文本，解决问题的成功率最高。

内容来源于stack exchange