如何借助googlesheets包检查电子表格中指定标题的工作表是否存在

我来给你一步步说明怎么用gspread（Python生态里最常用的Google Sheets操作包）完成这个需求：

1. 先搞定环境和授权 #

首先得确保你安装了必要的包：

pip install gspread google-auth

接下来是授权环节，有两种常用方式：

• 服务账号（适合自动化脚本）：去Google Cloud控制台创建服务账号，下载JSON密钥文件，把它放在你的项目目录里。
• 个人账号授权（适合手动运行）：直接用gspread.oauth()，运行时会弹出浏览器让你登录授权，操作更简单。

2. 连接到目标电子表格 #

不管用哪种授权方式，先建立和Google Sheets的连接，打开你要检查的目标表格：

import gspread
from google.oauth2.service_account import Credentials

# 服务账号授权方式
SCOPE = [
    "https://www.googleapis.com/auth/spreadsheets",
    "https://www.googleapis.com/auth/drive.file",
    "https://www.googleapis.com/auth/drive"
]
creds = Credentials.from_service_account_file('your-service-key.json', scopes=SCOPE)
client = gspread.authorize(creds)

# 或者用个人账号授权（注释掉上面的服务账号代码，用下面这行）
# client = gspread.oauth()

# 打开目标表格：可以用表格ID（URL里的长串字符），也可以用表格名称（如果名称唯一的话）
spreadsheet = client.open_by_key('your-spreadsheet-unique-id')
# 或者 spreadsheet = client.open('我的目标表格')

3. 核心检查逻辑 #

写一个简单的函数，获取所有工作表的标题，然后判断目标标题是否在列表里：

def is_worksheet_present(spreadsheet, target_title):
    # 获取所有工作表的标题列表
    all_worksheet_titles = [ws.title for ws in spreadsheet.worksheets()]
    # 直接判断是否存在（注意：Google Sheets的标题是大小写敏感的）
    return target_title in all_worksheet_titles

# 使用示例
target = "月度数据汇总"
if is_worksheet_present(spreadsheet, target):
    print(f"✅ 工作表 '{target}' 存在！")
else:
    print(f"❌ 工作表 '{target}' 不存在。")

额外小技巧 #

如果需要忽略大小写检查（比如用户输入的标题大小写和实际不一致），可以修改判断逻辑：

def is_worksheet_present_case_insensitive(spreadsheet, target_title):
    all_titles_lower = [ws.title.lower() for ws in spreadsheet.worksheets()]
    return target_title.lower() in all_titles_lower

这个方法效率很高，因为worksheets()会一次性拉取所有工作表的元数据，不需要逐个请求，即使表格里有几十上百个工作表也没问题。

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