如何用pygsheets获取谷歌表格非隐藏行并转为Pandas DataFrame？

好问题！pygsheets默认的get_as_df()方法会把所有行（包括隐藏行）都加载进来，要只保留未隐藏的行，我们可以利用pygsheets的行元数据功能来实现，下面是具体的解决方案：

核心思路 #

pygsheets的Worksheet对象提供了get_row_metadata()方法，能获取每行的隐藏状态。我们可以先拿到所有行的隐藏标记，再筛选出未隐藏的行，最后将这些行的数据转为DataFrame。

完整实现代码 #

import pygsheets
import pandas as pd

# 你的授权逻辑（保持不变）
gc = pygsheets.authorize(credentials=credentials)
sh = gc.open_by_key('KEY')
wks = sh.worksheet_by_title('SHEET 1')

# 1. 获取所有行的元数据，拿到隐藏状态
# start=1从第1行开始，end=wks.rows覆盖所有行
row_metadata = wks.get_row_metadata(start=1, end=wks.rows)

# 2. 筛选出未隐藏的行号（pygsheets行号从1开始）
unhidden_row_nums = [idx + 1 for idx, meta in enumerate(row_metadata) if not meta['hidden']]

# 3. 处理表头与数据行的对应关系
# 假设第1行是表头，先检查表头是否隐藏
is_header_hidden = row_metadata[0]['hidden']
if is_header_hidden:
    print("警告：表头行被隐藏，请确认表格结构是否符合预期")

# 4. 提取未隐藏数据并转为DataFrame
if unhidden_row_nums:
    # 分离表头行和数据行
    header_row = wks.get_row(unhidden_row_nums[0])
    # 提取除表头外的未隐藏数据行
    data_rows = wks.get_rows(row=unhidden_row_nums[1:])
    # 构造DataFrame
    filtered_df = pd.DataFrame(data_rows, columns=header_row)
else:
    filtered_df = pd.DataFrame()
    print("没有未隐藏的行")

# 查看结果
print(filtered_df)

关键细节说明 #

• 索引对应问题：pygsheets的行号是1-based（从1开始），而Pandas的DataFrame是0-based，代码中通过列表推导式处理了这个差异。
• 表头灵活性：如果你的表头不是第1行，只需要调整unhidden_row_nums中表头行的位置即可。
• 边界情况处理：代码中加入了表头隐藏的警告，以及无未隐藏行的判断，避免出现空数据报错。

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