使用gspread遍历行，用同行单元格和/差更新指定单元格

我是编程新手，想用Python的gspread库操作Google表格，实现遍历指定列的每行，把该行C列单元格设为同行A列与B列的和或差，但一直没成功。

我的初始代码如下（省略部分表格列）：

import gspread
from google.oauth2.service_account import Credentials

scopes = ["https://www.googleapis.com/auth/spreadsheets"]
creds = Credentials.from_service_account_file("credentials.json", scopes=scopes)
client = gspread.authorize(creds)

sheet_id = "url"
workbook = client.open_by_key(sheet_id)

worksheet_list = map(lambda x: x.title, workbook.worksheets())
new_worksheet_name = "template"

# 检查新工作表是否存在
if new_worksheet_name in worksheet_list:
    sheet = workbook.worksheet(new_worksheet_name)
else:
    sheet = workbook.add_worksheet(new_worksheet_name, rows=100, cols=30)

values = [
    ["Starting funds", "Bet", "Funds after bet"],
]

sheet.clear()

sheet.update(values, f"A1:Z{len(values)}")

sheet.update_acell("A2", 250)
sheet.update_acell("B2", 10)

我希望C2显示A2与B2的和/差，C3显示A3与B3的和/差，以此类推。尝试计算单元格差值时，我写了如下代码：

rows = sheet.get_all_values()
for row in rows[1:]:
    sheet.update_cell(row, 3, "=A:A-B:B")

但出现了如下报错：

File "path", line 72, in <module>
    sheet.update_cell(row, 3, "=A:A-B:B")
  File "path\.venv\Lib\site-packages\gspread\worksheet.py", line 751, in update_cell
    range_name = absolute_range_name(self.title, rowcol_to_a1(row, col))
                                                 ^^^^^^^^^^^^^^^^^^^^^^
  File "path\.venv\Lib\site-packages\gspread\utils.py", line 306, in rowcol_to_a1
    if row < 1 or col < 1:
       ^^^^^^^
TypeError: '<' not supported between instances of 'list' and 'int'

报错原因 #

sheet.get_all_values()返回的rows是二维列表，每个row是该行的单元格值列表（比如rows[1]是['250', '10', '']），而update_cell()的第一个参数需要整数类型的行号，不是列表，因此触发类型错误。另外，公式=A:A-B:B是整列运算，并非同行A、B单元格的差值，正确的同行公式应为=A{行号}-B{行号}（例如C2用=A2-B2）。

解决方法 #

推荐两种高效实现方式：

方式1：批量设置公式（最优） #

无需逐行遍历，直接给C列批量写入公式，效率更高：

# 获取有数据的行数（假设A、B列行数一致）
row_count = len(sheet.get_all_values()) - 1  # 减去表头行

# 生成C列公式列表，从第2行开始
formulas = [["=A{} - B{}".format(i+2, i+2)] for i in range(row_count)]

# 批量更新C2到C{row_count+1}的单元格
sheet.update("C2:C{}".format(row_count+1), formulas, value_input_option="USER_ENTERED")

• value_input_option="USER_ENTERED"会让Google表格将内容解析为用户手动输入的公式，而非纯文本。

方式2：遍历行号设置 #

若坚持逐行操作，需使用行号而非get_all_values()返回的行数据：

# 获取数据行数
row_count = len(sheet.get_all_values()) - 1

for row_num in range(2, row_count + 2):  # 从第2行到最后一行
    sheet.update_cell(row_num, 3, "=A{} - B{}".format(row_num, row_num))

额外优化建议 #

• 写入表头时，可将sheet.update(values, f"A1:Z{len(values)}")简化为sheet.update("A1:C1", values)，因为表头仅3列，无需写到Z列。
• 若后续需添加更多行数据，建议先批量写入A、B列数据，再批量设置C列公式，比逐行更新更高效。

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