Python gspread如何在不拉取全量数据时获取工作表最后一行

全量拉取整张表数据再通过长度定位最后一行的方式，在表数据量超过千行后会产生明显的带宽和性能浪费，完全没必要。下面是两种经过生产验证的低开销实现方式，全程不需要拉取全量数据：

方案1：通过元数据直接定位有数据的最后一行（性能最优，推荐） #

Google Sheets API本身支持只返回工作表的结构元数据，不需要传输任何单元格内容就能拿到已填充数据的范围边界，对应Python gspread库的实现代码如下：

# 仅拉取工作表结构元数据，请求体大小仅几KB
sheet_meta = worksheet.spreadsheet.fetch_sheet_metadata(
    params={"fields": "sheets.data.rowData"}
)
# 解析得到当前工作表实际填充了内容的最大行号
last_row_index = len(sheet_meta["sheets"][worksheet.index]["data"][0]["rowData"])

# 仅拉取最后一行的内容，按需调整列范围即可
last_row_content = worksheet.get_values(
    f"A{last_row_index}:Z{last_row_index}"
)[0]

整个流程总数据传输量不到全量拉取的1%，数据量越大性能优势越明显，高频调用场景优先选这个方案。

方案2：反向遍历定位非空行（兼容性最好） #

如果不方便调用内部元数据接口，可以从工作表物理最后一行往上反向遍历，每次只拉取单行数据做非空判断，一般1-2次请求就能命中目标行，开销远低于全量拉取：

# 从工作表配置的最大物理行号开始往上查
check_row = worksheet.row_count
last_row_content = []
while check_row > 0:
    current_row = worksheet.row_values(check_row)
    # 判断当前行是否存在非空内容
    if any(str(cell).strip() for cell in current_row):
        last_row_content = current_row
        break
    check_row -= 1

这个方案兼容所有版本的gspread库，不需要依赖非公开的内部属性，稳定性更高。

注意避坑 #

• 不要直接把worksheet.row_count当成最后一行的行号，这个值是工作表的物理总行数（新建空白表默认值为1000），不是实际填充了数据的行号
• 不要用worksheet.get_all_values()[-1]获取最后一行，这个方法会拉取整张表所有单元格内容，数据量过万行时请求延迟会达到数秒
• 不要尝试通过写入测试数据的方式复用append_rows()的定位逻辑，会在表里产生不必要的脏数据

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