使用gspread无法复制公式到新工作表？求高效解决方案

一、纠正你的误解：gspread支持获取和复制公式 #

gspread的get_all_values()方法默认返回单元格计算结果，但通过指定value_render_option='FORMULA'参数，可直接获取单元格中的原始公式。用这个方法就能直接复制公式到新工作表，无需绕路openpyxl。

实现代码 #

import gspread
from google.oauth2.service_account import Credentials

# 授权初始化gspread客户端
scope = ['https://www.googleapis.com/auth/spreadsheets']
creds = Credentials.from_service_account_file('/Users/k/Downloads/secret-elment-37.json', scope)
client = gspread.authorize(creds)

# 打开目标表格
spreadsheet = client.open("copy")
original_worksheet = spreadsheet.worksheet("12/13")

# 获取原工作表的所有公式（而非计算后的值）
original_formulas = original_worksheet.get_all_values(value_render_option='FORMULA')

# 创建新工作表
new_worksheet = spreadsheet.add_worksheet(title="1/1", rows=len(original_formulas), cols=len(original_formulas[0]))

# 将公式写入新工作表
new_worksheet.update('A1', original_formulas, value_input_option='USER_ENTERED')

• 关键参数说明：
  • value_render_option='FORMULA'：获取单元格的原始公式，而非计算结果
  • value_input_option='USER_ENTERED'：让Google Sheets将输入内容识别为公式，而非纯文本

二、最优方案：直接复制整个工作表（含公式、格式、数据） #

你最后尝试的duplicateSheet批量请求是最高效的方法，它直接在云端复制整个工作表，包括所有公式、格式、数据，完全无需手动遍历或处理单元格。这是调用Google Sheets API的原生复制功能，比手动复制内容更可靠。

优化后的清晰代码 #

from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

# 授权初始化Sheets API服务
scope = ['https://www.googleapis.com/auth/spreadsheets']
creds = Credentials.from_service_account_file('/Users/k/Downloads/secret-elment-37.json', scope)
service = build('sheets', 'v4', credentials=creds)

# 目标表格ID和原工作表ID
spreadsheet_id = '16yQw4DjuJpzGgdz3Jk'
source_sheet_id = '153016'

# 构造复制请求
request_body = {
    'requests': [
        {
            'duplicateSheet': {
                'sourceSheetId': source_sheet_id,
                'newSheetName': 'TargetSheet'
            }
        }
    ]
}

# 执行复制操作
response = service.spreadsheets().batchUpdate(
    spreadsheetId=spreadsheet_id,
    body=request_body
).execute()

print(f"复制完成，新工作表ID：{response['replies'][0]['duplicateSheet']['newSheetId']}")

• 方法优势：
  • 一键复制所有内容：公式、格式、数据、验证规则等全部保留
  • 云端操作，无需下载上传，速度更快
  • 避免手动处理单元格时的格式丢失或公式错误

三、你之前代码的问题说明 #

1. openpyxl本地处理：虽能实现，但步骤繁琐，效率低，易出现格式兼容问题
2. gspread默认get_all_values：默认返回计算后的值，而非公式，导致复制后只有数值、无公式逻辑
3. duplicateSheet代码：这本身就是正确的最优方案，它调用Google Sheets原生复制功能，是最推荐的方式

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