MultiIndex Pandas DataFrame列命名与gspread-pandas谷歌表格写入优化问题

问题1：DataFrame列命名失效 #

用户尝试两种列命名操作均未达到预期：

• 执行df.columns = ['col 1', 'col 2' 'col 3']时，因列表元素少写逗号，触发ValueError: Length mismatch错误
• 执行df = df.rename(columns={'0': 'Col1', '1': 'Col2', '2': 'Col3'})无报错，但列名仍为0、1、2

正确处理方式 #

# 方式1：直接赋值列名（注意元素间的逗号分隔）
df.columns = ['Col1', 'Col2', 'Col3']

# 方式2：使用rename时，用整数类型匹配原始列名（而非字符串）
df = df.rename(columns={0: 'Col1', 1: 'Col2', 2: 'Col3'})

问题2：gspread-pandas写入谷歌表格时多级索引重复填充 #

用户通过Spread.df_to_sheet写入带MultiIndex的DataFrame时，多级索引每行都会重复显示，希望实现类似Jupyter Notebook的显示效果：仅在索引值变化时显示，其余行对应位置留空。

实现方法 #

先将MultiIndex转换为去重后的普通列，再写入表格：

1. 处理多级索引，替换重复值为空字符串：

# 将多级索引转换为DataFrame
index_df = df.index.to_frame(index=False)

# 遍历索引列，将与上一行相同的值替换为空
for col in index_df.columns:
    index_df[col] = index_df[col].where(index_df[col] != index_df[col].shift(1), '')

# 合并处理后的索引列与原数据列
formatted_df = pd.concat([index_df, df.reset_index(drop=True)], axis=1)

2. 写入谷歌表格（此时无需再保留原索引）：

s.open_sheet('test')
Spread.df_to_sheet(s, formatted_df, index=False, headers=True, start='A8', replace=False)

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