如何通过gspread实现嵌套列表的添加操作

核心逻辑 #

gspread 原生支持二维嵌套列表与电子表格的行列映射规则：嵌套列表里的每个子列表对应电子表格的一整行，子列表内的每个元素对应该行从起始列开始的逐列单元格值，不需要额外做格式转换就能直接写入。

常用实现方式 #

• 在已有数据末尾追加嵌套列表
  直接调用工作表对象的*append_rows()*方法，把待写入的嵌套列表传进去就行。方法会自动找到当前工作表有效数据的最后一行，从下一行开始逐行写入嵌套列表的内容，完全不会覆盖原有数据。
  示例代码：

  import gspread
  # gspread授权连接、获取目标工作表ws的流程省略
  nested_data = [
    ["第一列内容", "第二列内容", "第三列内容"],
    ["第二行第一列", "第二行第二列", "第二行第三列"],
    ["第三行第一列", "第三行第二列", "第三行第三列"]
  ]
  ws.append_rows(nested_data)
  

• 从指定位置写入嵌套列表
  调用工作表对象的*update()*方法，把目标写入区域的起始单元格坐标作为范围参数传入，同时把嵌套列表赋值给values参数。方法会从指定的起始单元格开始，严格按照嵌套列表的行列结构填充对应区域，适合在已有表格的指定位置插入结构化数据。
  示例代码：

  # 从A10单元格位置开始写入上述nested_data
  ws.update("A10", values=nested_data)
  

• 全量清空后写入嵌套列表
  先调用ws.clear()清空工作表所有原有内容，再从A1单元格位置调用上述*update()*方法传入嵌套列表，就能完成整张表的内容重构。

实操注意点 #

• 嵌套列表里的空单元格请用None占位，不要传空字符串，不然会触发对应位置的单元格格式被重置
• 如果嵌套列表的总列数超过工作表当前的最大列数，gspread 会自动扩展工作表的列范围，不用手动调整表格尺寸
• 要是嵌套列表里不同子列表的长度不一致，gspread 会按照最长的子列表长度自动对齐，不足的位置默认留空

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