Python导入Excel时如何实现单Sheet自动读取、多Sheet弹窗选择

你现有代码的核心问题是硬编码指定了sheet_name=1（pandas工作表索引从0开始，该参数实际会读取第二个工作表），没有适配单表/多表的不同场景。以下优化完全基于你已引入的依赖实现，不需要额外安装第三方包，完全满足提出的功能要求：

• 单工作表文件自动读取唯一表
• 多工作表文件弹出图形化选择框供用户指定目标表

核心实现逻辑 #

1. 用户选择文件后，先轻量读取文件的所有工作表名称（不会加载全量表格数据，无额外性能损耗）
2. 校验工作表数量：
   • 仅1个工作表时，直接读取该表为DataFrame
   • 工作表数≥2时，弹出选择窗口展示所有工作表名称，用户选中确认后再读取对应表
3. 增加异常兜底：处理用户取消选文件、取消选工作表、文件损坏无法读取的场景，避免程序直接报错崩溃

优化后完整代码 #

import pandas as pd
import tkinter as tk
from tkinter import filedialog, messagebox

def select_sheet(sheet_names):
    """多工作表场景下的工作表选择弹窗"""
    select_win = tk.Tk()
    select_win.title("选择要导入的工作表")
    select_win.geometry("300x250")
    
    selected = None
    
    # 工作表列表组件
    list_label = tk.Label(select_win, text="请选择目标工作表：")
    list_label.pack(pady=5)
    sheet_list = tk.Listbox(select_win, listvariable=tk.StringVar(value=sheet_names), width=40, height=10)
    sheet_list.pack(pady=5)
    # 默认选中第一个工作表
    sheet_list.selection_set(0)
    
    def confirm_select():
        nonlocal selected
        if not sheet_list.curselection():
            messagebox.showwarning("提示", "请先选择一个工作表")
            return
        selected = sheet_list.get(sheet_list.curselection())
        select_win.destroy()
    
    confirm_btn = tk.Button(select_win, text="确认导入", command=confirm_select)
    confirm_btn.pack(pady=10)
    
    select_win.mainloop()
    return selected

if __name__ == "__main__":
    # 初始化根窗口并隐藏
    root = tk.Tk()
    root.withdraw()
    
    # 弹出文件选择框，仅过滤展示Excel格式文件
    file_path = filedialog.askopenfilename(
        title="选择要导入的Excel文件",
        filetypes=[("Excel文件", "*.xlsx *.xls *.xlsm")]
    )
    if not file_path:
        messagebox.showinfo("提示", "未选择任何文件，程序退出")
        exit()
    
    # 读取文件所有工作表名称
    try:
        excel_file = pd.ExcelFile(file_path)
        all_sheets = excel_file.sheet_names
    except Exception as e:
        messagebox.showerror("错误", f"文件读取失败：{str(e)}")
        exit()
    
    # 根据工作表数量走不同读取逻辑
    if len(all_sheets) == 1:
        target_sheet = all_sheets[0]
    else:
        target_sheet = select_sheet(all_sheets)
        # 处理用户直接关闭选择窗口的情况
        if not target_sheet:
            messagebox.showinfo("提示", "未选择工作表，程序退出")
            exit()
    
    # 读取目标数据为DataFrame
    df = pd.read_excel(excel_file, sheet_name=target_sheet)
    print(f"成功读取工作表【{target_sheet}】，数据共{len(df)}行，{len(df.columns)}列")
    # 后续可直接使用df开展数据处理

使用说明 #

• 运行代码后首先弹出文件选择框，仅展示Excel格式的文件供选择
• 如果选中的文件只有1个工作表，控制台会输出读取成功的提示，直接得到对应DataFrame
• 如果选中的文件有多个工作表，会弹出列表选择窗口，选中目标表点确认即可完成读取
• 所有取消操作、文件读取错误都会有明确提示，不会抛出无意义的堆栈错误

注：原代码最后一行直接写变量名x是Jupyter类交互环境的写法，普通py脚本运行不会输出内容，优化版增加了明确的读取成功提示，你可以根据自己的使用场景调整后续数据处理逻辑。

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