本文讲解如何通过函数返回值安全、清晰地在函数外部获取并使用 dataframe，避免滥用 global 带来的可维护性与作用域问题，并提供简洁可复用的文件读取实践方案。
在 Tkinter GUI 应用中，常需通过按钮触发文件选择并加载 Excel/CSV 数据到 Pandas DataFrame（如 df1、df2），再在后续逻辑中进行比对分析。但若像原代码中那样在嵌套函数（如 open_file1()）内用 global df1 声明并在外层直接 print(df1)，极易因作用域执行顺序导致 NameError: name 'df1' is not defined —— 因为 df1 仅在用户点击按钮后才被赋值，而 print(df1) 在 window2 创建时就立即执行，此时变量尚未初始化。
✅ 正确做法是：让文件加载函数明确返回 DataFrame，由调用方决定何时、如何存储和使用它。这不仅符合 Python 函数式编程原则，也大幅提升代码可测试性与可维护性。
以下是一个优化后的核心实践示例：
import tkinter as tk
import pandas as pd
from tkinter.filedialog import askopenfilename
def load_excel_file(title="Select Excel file"):
"""弹出文件对话框，读取并返回 DataFrame；失败时返回 None"""
filepath = askopenfilename(
title=title,
filetypes=[("All files", "*.*"), ("CSV Files", "*.csv"), ("Excel files", "*.xlsx")]
)
if not filepath:
tk.messagebox.showwarning("Warning", "No file selected.")
return None
try:
return pd.read_excel(filepath)
except Exception as e:
tk.messagebox.showerror("Error", f"Failed to read file:\n{e}")
return None
# 在需要使用数据的位置（例如点击“Read”按钮时）：
def on_read_clicked():
global df1, df2 # ✅ 此处声明 global 是合理且可控的（在顶层回调中）
df1 = load_excel_file("Select FIRST file")
df2 = load_excel_file("Select SECOND file")
if df1 is not None and df2 is not None:
# ✅ 现在可以安全进行列比对，例如：
# common_warnings = df1['Compiler Warnings'].isin(df2['Compiler Warnings'])
print("Both files loaded successfully.")
print(f"df1 shape: {df1.shape}, df2 shape: {df2.shape}")
else:
print("One or both files failed to load.")
# 绑定到按钮：
button4 = tk.Button(window2, text="Read", width=20, command=on_read_clicked)
button4.grid(row=4, column=1)? 关键要点总结：
- ❌ 避免在深层嵌套回调（如 open_file1()）中用 global 暗中修改变量，易引发竞态与调试困难；
- ✅ 将文件加载逻辑封装为纯函数（load_excel_file()），职责单一、可复用、易单元测试；
- ✅ 使用 global 仅限于明确的顶层事件处理函数（如 on_read_clicked），确保赋值时机可控；
- ✅ 始终检查返回值是否为 None，防止空 DataFrame 引发后续 KeyError 或 AttributeError；
- ✅ 如需跨多个窗口共享数据，可考虑使用类封装（如 class DataController）管理 df1/df2 属性，进一步提升工程健壮性。
通过这种结构化设计，你不仅能顺利在函数外部访问 DataFrame，还能为后续的列比对（如 df1[col].isin(df2[col])）、合并（pd.merge）或差异分析打下坚实基础。
