如何用Tkinter选择Excel/CSV文件并转为DataFrame解决合并报错？

错误原因分析 #

你遇到的TypeError: Can only merge Series or DataFrame objects, a <class 'tuple'> was passed.错误，根源有两个：

1. askopenfilenames返回值类型错误：这个函数返回的是元组（即使只选一个文件，也是长度为1的元组），而Pandas的read_excel/read_csv需要传入字符串格式的文件路径，直接把元组传给读取函数会导致后续拿到的不是DataFrame，而是无效对象。
2. 变量未正确传递：原cleanup函数里的excel_file是未定义的变量，根本没有用到你通过Tkinter选择的文件路径。

解决方案 #

步骤1：修正Tkinter文件选择逻辑 #

如果你只需要选择单个文件，改用askopenfilename（单数形式），它会直接返回字符串格式的文件路径；同时隐藏Tkinter的空白主窗口，提升体验：

import tkinter as tk
import tkinter.filedialog as fd

# 初始化并隐藏主窗口
root = tk.Tk()
root.withdraw()

# 选择第一个文件，限制文件类型为Excel/CSV
file_path_1 = fd.askopenfilename(
    parent=root,
    title="选择第一个对比文件",
    filetypes=[("Excel/CSV文件", "*.xlsx *.xls *.csv")]
)

# 选择第二个文件
file_path_2 = fd.askopenfilename(
    parent=root,
    title="选择第二个对比文件",
    filetypes=[("Excel/CSV文件", "*.xlsx *.xls *.csv")]
)

# 处理用户取消选择的情况
if not file_path_1 or not file_path_2:
    print("已取消文件选择")
    exit()

步骤2：将文件转为DataFrame #

编写通用读取函数，自动识别文件类型（Excel/CSV）并转为DataFrame：

import pandas as pd

def get_dataframe(file_path, sheet_name="***"):
    # 根据文件后缀判断读取方式
    if file_path.endswith((".xlsx", ".xls")):
        return pd.read_excel(file_path, sheet_name=sheet_name)
    elif file_path.endswith(".csv"):
        return pd.read_csv(file_path)
    else:
        raise ValueError("仅支持Excel(.xlsx/.xls)和CSV(.csv)格式文件")

# 读取两个文件为DataFrame
df1 = get_dataframe(file_path_1)
df2 = get_dataframe(file_path_2)

步骤3：执行合并并保存结果 #

现在可以正常执行Pandas合并操作：

# 执行数据合并
merged_df = pd.merge(
    left=df1,
    right=df2,
    left_on="User Name",
    right_on="ExternalID",
    how="right"
)

# 保存合并结果到CSV
merged_df.to_csv("matched.csv", index=False)

完整整合代码 #

把以上部分整合为完整可运行的代码：

import tkinter as tk
import tkinter.filedialog as fd
import pandas as pd

def get_dataframe(file_path, sheet_name="***"):
    if file_path.endswith((".xlsx", ".xls")):
        return pd.read_excel(file_path, sheet_name=sheet_name)
    elif file_path.endswith(".csv"):
        return pd.read_csv(file_path)
    else:
        raise ValueError("仅支持Excel(.xlsx/.xls)和CSV(.csv)格式文件")

if __name__ == "__main__":
    # 初始化Tkinter并隐藏主窗口
    root = tk.Tk()
    root.withdraw()

    # 选择文件
    file_path_1 = fd.askopenfilename(
        parent=root,
        title="选择第一个对比文件",
        filetypes=[("Excel/CSV文件", "*.xlsx *.xls *.csv")]
    )
    file_path_2 = fd.askopenfilename(
        parent=root,
        title="选择第二个对比文件",
        filetypes=[("Excel/CSV文件", "*.xlsx *.xls *.csv")]
    )

    if not file_path_1 or not file_path_2:
        print("已取消文件选择")
        exit()

    # 读取为DataFrame
    try:
        df1 = get_dataframe(file_path_1)
        df2 = get_dataframe(file_path_2)
    except Exception as e:
        print(f"文件读取失败：{str(e)}")
        exit()

    # 合并数据
    try:
        merged_df = pd.merge(
            left=df1,
            right=df2,
            left_on="User Name",
            right_on="ExternalID",
            how="right"
        )
        merged_df.to_csv("matched.csv", index=False)
        print("数据合并完成，结果已保存为matched.csv")
    except KeyError as e:
        print(f"合并失败：找不到指定列 {str(e)}")
    except Exception as e:
        print(f"合并失败：{str(e)}")

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