使用pd.ExcelWriter写入Excel文件失败的问题求助

错误原因分析 #

ValueError: Must pass explicit sheet_name or set cur_sheet property 这个报错的核心是：你在使用pd.ExcelWriter写入数据时，没有明确指定要写入的工作表名称，或者操作过程中未正确关联目标工作表。ChatGPT生成的代码大概率忽略了「保留所有原有工作表」的需求，或是写入时未传入sheet_name参数。

修正后的完整代码 #

import pandas as pd

# 定义字符串到数值的映射字典
response_map = {
    'Very likely': 1,
    'Likely': 2,
    'Unlikely': 3,
    'Very Unlikely': 4
}

# 指定需要修改的三个工作表名称（替换为你实际的表名）
target_sheets = ['表1', '表2', '表3']
file_path = '你的文件路径.xlsx'

# 读取整个Excel文件的所有工作表
xls = pd.ExcelFile(file_path)
all_sheets = {sheet: xls.parse(sheet) for sheet in xls.sheet_names}

# 处理目标工作表的q11、q12列
for sheet_name in target_sheets:
    if sheet_name in all_sheets:
        df = all_sheets[sheet_name]
        # 执行映射替换，保留原列结构
        df['q11'] = df['q11'].map(response_map)
        df['q12'] = df['q12'].map(response_map)
        all_sheets[sheet_name] = df

# 将所有工作表写回原文件（保留全部表名和未修改的表）
with pd.ExcelWriter(file_path, engine='openpyxl', mode='w') as writer:
    for sheet_name, df in all_sheets.items():
        df.to_excel(writer, sheet_name=sheet_name, index=False)

关键细节说明 #

• 读取所有工作表：用pd.ExcelFile一次性读取全文件的工作表，既避免重复IO操作，又能完整保留原文件的所有表结构。
• 映射替换逻辑：用字典配合map()方法实现批量替换，比循环判断更高效；如果需要保留空值或未匹配的字符串，可改用df['q11'].replace(response_map, inplace=True)。
• 写入时指定sheet_name：在to_excel()中明确传入工作表名称，这是解决报错的核心——必须告知ExcelWriter数据要写入的具体工作表。
• 保留原工作表：遍历所有读取到的工作表（包括无需修改的）写入回文件，避免原文件其他工作表丢失。

额外注意事项 #

• 确保安装了openpyxl库（处理.xlsx文件的依赖），未安装则执行pip install openpyxl。
• 若q11/q12列存在非映射内的内容，map()会将其转为NaN，可根据需求调整替换逻辑。

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