Apps Script创建的Google Sheets图表无法将表头显示为系列名称

DevOps 小满

2026-7-4

解决Google Apps Script柱状图系列名称空白问题

问题原因

你当前的代码默认采用行作为数据系列的模式处理A1:M2范围：第一行的表头文本被当作一个系列（无法在柱状图中渲染），第二行的数值作为第二个系列，导致图例和列标题无有效内容，呈现空白状态。而你需要的是每一列作为一个独立系列，并将第一行的表头文本作为系列名称。

解决方案

在图表构建器中添加两个关键配置选项：

rowsAsSeries: false：强制图表以列而非行为数据系列
useFirstRowAsHeaders: true：将第一行的单元格文本设为对应列系列的名称（即图例标签）

修改后的完整代码

function createTestChart() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("TestSheet");
  
  // 包含表头和数据的范围
  var chartRange = sheet.getRange("A1:M2");

  var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.COLUMN)
    .addRange(chartRange)
    .setPosition(5, 5, 0, 0)
    .setOption('title', 'Test Chart from A1:M2')
    // 核心修改1：以列作为数据系列
    .setOption('rowsAsSeries', false)
    // 核心修改2：用第一行文本作为系列名称
    .setOption('useFirstRowAsHeaders', true)
    // 可选：设置图例位置，确保显示
    .setOption('legend', {position: 'right'});

  var chart = chartBuilder.build();
  sheet.insertChart(chart);
}