使用Google Sheets API追加数据位置随机，如何固定至底部？

你遇到的问题确实是筛选导致的——当表格开启筛选时，append方法如果指定整列（如A:A），API会将数据插入到筛选后可见区域的末尾，而非整个工作表的真实底部。再加上你用了INSERT_ROWS选项，会根据当前筛选的可见行位置插入新行，所以才会出现位置随机的情况。

下面是几个可靠的解决办法：

方案1：修改Range为工作表名称（推荐） #

把range从SheetName!A:A改成仅工作表名称（比如Sheet1），这样API会自动识别工作表中真实的有效数据区域（完全忽略筛选隐藏的行），直接在真实底部追加数据。

修改后的代码：

const result = await sheets.spreadsheets.values.append({
    spreadsheetId: spreadsheetId,
    range: "SheetName", // 仅指定工作表名
    valueInputOption: "RAW",
    insertDataOption: "INSERT_ROWS",
    resource: {
        values: data
    }
});

方案2：指定包含所有数据列的范围 #

如果必须指定列范围，不要用单个整列，而是覆盖所有实际用到的列（比如SheetName!A:Z），这样API会基于整个数据区域的真实底部判断插入位置，不受筛选状态影响：

const result = await sheets.spreadsheets.values.append({
    spreadsheetId: spreadsheetId,
    range: "SheetName!A:Z", // 覆盖所有数据列
    valueInputOption: "RAW",
    insertDataOption: "INSERT_ROWS",
    resource: {
        values: data
    }
});

方案3：先获取真实最后一行再插入 #

如果需要精确控制插入位置，可以先调用API获取工作表的最后一行行号，然后构造指向该行下一行的range，确保插入到绝对底部：

// 先获取A列的所有行，计算最后一行的下一行行号
const getResponse = await sheets.spreadsheets.values.get({
    spreadsheetId: spreadsheetId,
    range: "SheetName!A:A",
    majorDimension: "ROWS"
});
const lastRow = getResponse.values ? getResponse.values.length + 1 : 1;

// 追加数据到真实底部
const result = await sheets.spreadsheets.values.append({
    spreadsheetId: spreadsheetId,
    range: `SheetName!A${lastRow}`, // 指定具体起始行
    valueInputOption: "RAW",
    insertDataOption: "INSERT_ROWS",
    resource: {
        values: data
    }
});

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