如何将Google Sheets工作簿转为pandas.io.excel._base.ExcelFile类型

核心点：gspread.spreadsheet.Spreadsheet 和 pandas.io.excel._base.ExcelFile 是完全不同的对象，不存在直接类型转换的方法。正确思路是从Google Sheets中提取对应工作表的数据，转换为pandas可处理的结构，适配原有代码逻辑。

正确实现步骤 #

1. 获取指定工作表 #

Spreadsheet对应Excel里的整个工作簿，需先从中取出具体工作表（对应ExcelFile中的单个sheet）：

# 方式1：通过工作表名称获取
worksheet = workbook.worksheet("你的工作表名称")
# 方式2：直接获取第一个工作表
worksheet = workbook.sheet1

2. 将工作表数据转为DataFrame #

这是最直接适配原有代码的方式，因为原有代码最终也是从ExcelFile读取数据到DataFrame：

# 自动识别表头，将记录转为DataFrame
df = pd.DataFrame(worksheet.get_all_records())
# 若不需要表头，直接读取所有值转换
# df = pd.DataFrame(worksheet.get_all_values())

3. 模拟ExcelFile的parse()逻辑（可选） #

如果原有代码依赖ExcelFile的parse()方法读取不同sheet，可以封装简单工具函数模拟该行为：

def parse_google_sheet(spreadsheet, sheet_name):
    worksheet = spreadsheet.worksheet(sheet_name)
    return pd.DataFrame(worksheet.get_all_records())

# 使用方式和ExcelFile.parse()完全一致
df = parse_google_sheet(workbook, "Sheet1")

修复你尝试过的错误代码 #

你之前的代码问题在于未正确获取worksheet对象：

# 错误写法（未获取工作表）
# f = workbook.sheet_to_df
# 正确写法
worksheet = workbook.sheet1
f = pd.DataFrame(worksheet.get_all_records())

完整替换示例 #

把原有读取Excel的代码替换为读取Google Sheets的逻辑：

import gspread
from oauth2client.service_account import ServiceAccountCredentials
import pandas as pd

# 初始化gspread客户端
scope = ['https://spreadsheets.google.com/feeds', 'https://www.googleapis.com/auth/drive']
google_key_file = "relic-list-project.json"
credentials = ServiceAccountCredentials.from_json_keyfile_name(google_key_file, scope)
gc = gspread.authorize(credentials)

# 打开Google Sheets工作簿
workbook = gc.open_by_key('你的spreadsheet_key')

# 替换原有ExcelFile读取逻辑
worksheet = workbook.sheet1
df = pd.DataFrame(worksheet.get_all_records())

# 后续原有处理DataFrame的代码可直接复用
print(df.head())

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