Python脚本更新Google Sheet时丢失手动录入数据问题求助

• 并发编辑冲突：脚本运行时如果有用户正在手动操作Sheet（输入数据、调整格式等），Google Sheets的实时协作机制会导致读写冲突。脚本读取手动列数据时可能拿到未同步的旧数据，或者写入时直接覆盖用户刚编辑的内容，最终表现为数据丢失。
• 筛选/隐藏列的干扰：部分Google Sheets操作库（如gspread）默认读取可见单元格，如果用户设置了筛选或隐藏列，脚本读取的手动列数据会不完整；另外筛选后行顺序被打乱，会导致VLOOKUP匹配时关联错误，手动数据被匹配到错误行，看起来像是丢失。

• 添加并发控制：脚本执行前通过API锁定目标工作表，禁止用户编辑，执行完成后解锁。示例代码（基于gspread）：

import gspread
from gspread.models import Protection

gc = gspread.service_account()
sheet = gc.open("你的表格").worksheet("目标工作表")
# 创建临时保护，仅脚本服务账号可编辑
protection = Protection(
    range=sheet.range("A:Z"),
    description="脚本更新中，临时锁定",
    warning_only=False,
    editors={"users": ["你的服务账号邮箱"]}
)
sheet.batch_update({"requests": [{"addProtectedRange": {"protectedRange": protection}}]})

# 执行数据更新操作...

# 解除保护
sheet.batch_update({"requests": [{"deleteProtectedRange": {"protectedRangeId": protection.id}}]})

• 精准指定读取范围：不要读取整个工作表，直接指定手动列和唯一ID的固定单元格范围（比如A:A, D:D, E:E），确保无论列是否隐藏/筛选，都能读取到完整数据。同时读取时保留所有唯一ID，避免因空行跳过导致关联错误。
• 在Python内完成数据匹配：放弃Sheet内的VLOOKUP公式，改用Pandas的merge方法在代码中关联数据。基于唯一ID做左连接，确保手动列数据准确对应到刷新后的SQL行，避免公式计算延迟或筛选导致的匹配错误：

import pandas as pd

# 读取手动列和ID
manual_data = sheet.get_values("A2:C1000")  # A=ID, B/C=手动列
manual_df = pd.DataFrame(manual_data, columns=["id", "manual_col1", "manual_col2"])
# 获取SQL最新数据
sql_df = fetch_latest_sql_data()
# 左连接保留SQL数据，关联手动列
final_df = pd.merge(sql_df, manual_df, on="id", how="left")
# 写入Sheet，覆盖数据范围
sheet.update("A2", final_df.values.tolist())

• 增加数据校验与回滚：脚本执行后，对比执行前后手动列的非空数据量，若差异超出阈值，自动恢复到上一个版本并发送告警。可利用Google Sheets的版本历史API获取版本ID，触发回滚操作。
• 拆分工作表隔离操作：把自动更新数据和手动维护内容拆分到不同工作表：
  • 工作表1：仅存放脚本更新的SQL数据（含唯一ID）
  • 工作表2：用户手动维护列（含唯一ID）
  • 工作表3：用户可见的汇总表，用跨表公式（如=VLOOKUP(A2, 工作表1!A:Z, 2, FALSE)）关联数据，用户仅操作工作表2或3，脚本只更新工作表1，彻底避免覆盖风险。

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