如何通过Google Apps Script更新Google Sheets图表的X轴与系列范围

问题原因 #

你之前的脚本存在两个问题：

1. 调用clearRanges后添加范围的顺序没有固定规则，Google Sheets会随机识别X轴和系列的对应关系，导致配置丢失
2. 硬写series配置直接覆盖了原有图表的自定义设置（比如系列名称、样式、数据标签等），编辑时就会看到原有设置消失

正确实现方案 #

Google Apps Script操作图表时，范围的添加顺序直接决定映射逻辑：第一个添加的范围为X轴标签范围，后续依次添加的范围对应第0到第N个系列，只要严格按这个顺序传参，同时保留原有配置即可解决问题。
修正后的代码如下：

function updateChartRanges(sheet, chart, type, ranges) {
    // 保留原有图表的所有自定义配置，避免样式、系列名丢失
    const existingOptions = chart.getOptions();
    const existingSeries = existingOptions.get('series', {});
    const existingHAxis = existingOptions.get('hAxis', {});
    const newChartBuilder = chart.modify().clearRanges();

    // 按固定顺序添加范围：第一个=X轴，后续=对应系列
    ranges.forEach(range => newChartBuilder.addRange(range));

    // 合并原有系列配置和轴索引设置，不覆盖原有自定义内容
    const seriesConfig = {};
    const seriesCount = type === 'column' ? 4 : 5;
    for(let i = 0; i < seriesCount; i++) {
        seriesConfig[i] = {
            ...(existingSeries[i] || {}),
            targetAxisIndex: i === 0 ? 1 : 0
        }
    }

    newChartBuilder
        .setOption('series', seriesConfig)
        .setOption('hAxis', existingHAxis); // 保留原有X轴配置

    const newChart = newChartBuilder.build();
    sheet.updateChart(newChart);
    SpreadsheetApp.flush();
}

调用注意事项 #

• 传入的ranges数组必须严格按照[X轴标签范围, 系列1数值范围, 系列2数值范围……]的顺序排列，顺序错误会直接导致映射失败
• 若你的X轴范围是固定的只有行号变化，只需要每次动态生成对应行的范围按顺序传入即可，不需要额外配置X轴映射

问题截图参考 #

运行数天后不同步的效果：

原始正常效果：

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