使用PyInstaller打包后Python GUI文件管理器运行异常

我用Python写了一个带GUI的简易文件管理器，在conda环境下直接运行app.py完全正常，但用PyInstaller生成可执行文件后，会触发try-catch块里的自定义错误提示。

我在MacOS系统下，先试了pyinstaller --onefile app.py命令打包，后来参考相关问题改用pyinstaller --onedir app.py，但问题依旧。

相关代码 #

app.py #

from tkinter import *
import os
from ttkthemes import ThemedTk
from tkinter import filedialog, messagebox, ttk
from constants import *
from main import establish_current_dir, organize_files, TARGET_DIR_

BG_COLOR_ = "#252629" 

def browse_folder(folder_label: str):
    global target_folder
    target_folder = filedialog.askdirectory()
    folder_name = os.path.basename(target_folder)
    folder_label.config(text=f"Selected Folder: {folder_name}")

def organize_files_gui():
    if not target_folder:
        messagebox.showerror("Error", "Please select a folder.")
        return

    files = establish_current_dir()
    organize_files(files)
    messagebox.showinfo("Success", "Files organized.")

def main():
    root = ThemedTk(theme="Adapta")
    root.title("File Organizer")
    
    root.geometry("400x200")
    root.configure(bg=BG_COLOR_)

    folder_label_frame = Frame(root) 
    folder_label_frame.pack(side="top", fill="x", pady=0) 
    
    folder_label = Label(folder_label_frame, text="Selected Folder: ")
    folder_label = Label(folder_label_frame, text="Selected Folder: ", foreground="#FFFFFF")
    folder_label.pack(side="top", anchor="center")
    
    made_by_label = Label(root, text="Made by Jakob™", fg = "#9d9ea3", bg = BG_COLOR_, font=("Helvetica", 32))
    made_by_label.place(relx=0.5, rely=0.5, anchor="center")
    
    style = ttk.Style()
    style.configure("Custom.TButton", foreground="#FFFFFF", background="#FFFDD0",
                    borderwidth=0, relief="groove")

    button_frame = Frame(root, bg= BG_COLOR_) 
    button_frame.pack(side="bottom")

    select_folder_button = ttk.Button(button_frame, text="Select Folder", command=lambda: browse_folder(folder_label), style="Custom.TButton")
    select_folder_button.pack(side="left", padx=10, pady=20)

    organize_button = ttk.Button(button_frame, text="Organize Files", command=organize_files_gui, style="Custom.TButton")
    organize_button.pack(side="right", padx=10, pady=20)
    
    root.mainloop()

if __name__ == "__main__":
    target_folder = ""
    main()

main.py（补充内容） #

def establish_current_dir() -> List[str]:
    try:
        with os.scandir(TARGET_DIR_) as entries:
            files = [entry.name for entry in entries] # if entry.is_file()
            return files
        
    except FileNotFoundError:
        print(ERROR_MSG_)   
        sys.exit()

核心问题1：TARGET_DIR_ 未与用户选择的文件夹关联 #

你在browse_folder函数里把用户选择的路径存在全局变量target_folder，但establish_current_dir函数却用了导入的常量TARGET_DIR_，两者没有任何关联。不管是conda环境还是打包后，只要TARGET_DIR_指向的路径不存在，就会触发FileNotFoundError。

解决方法：
修改organize_files_gui函数，把选中的target_folder传递给establish_current_dir，同时修改main.py里的函数接收这个参数：

修改后的app.py中organize_files_gui： #

def organize_files_gui():
    if not target_folder:
        messagebox.showerror("Error", "Please select a folder.")
        return

    files = establish_current_dir(target_folder)  # 传入选中的文件夹路径
    organize_files(files, target_folder)  # 如果organize_files也需要路径，同样传入
    messagebox.showinfo("Success", "Files organized.")

修改后的main.py： #

import os
import sys
from typing import List
from constants import ERROR_MSG_

def establish_current_dir(target_dir: str) -> List[str]:
    try:
        with os.scandir(target_dir) as entries:
            files = [entry.name for entry in entries] # 可取消注释过滤文件：if entry.is_file()
            return files
        
    except FileNotFoundError:
        print(ERROR_MSG_)   
        sys.exit()

核心问题2：PyInstaller打包时可能遗漏ttkthemes主题文件 #

ttkthemes的主题文件是外部资源，PyInstaller默认不会自动打包这些文件，导致打包后的程序找不到"Adapta"主题，可能引发隐性连锁错误。

解决方法：

1. 获取ttkthemes主题目录：在conda环境下运行以下命令，得到主题路径：

   python -c "import ttkthemes; print(ttkthemes.themes_path())"
   

2. 打包时用--add-data参数包含主题目录：
   • 用--onedir打包的命令：

     pyinstaller --onedir --add-data "<主题路径>:ttkthemes/themes" app.py
     

   • 用--onefile打包的命令：

     pyinstaller --onefile --add-data "<主题路径>:ttkthemes/themes" app.py
     

   把<主题路径>替换成你实际获取到的路径。

核心问题3：异常处理不够友好 #

当前establish_current_dir捕获错误后直接sys.exit()，会导致GUI程序直接崩溃，用户看不到明确的图形化提示。建议改成调用tkinter的messagebox：

修改后的main.py异常处理： #

def establish_current_dir(target_dir: str) -> List[str]:
    try:
        with os.scandir(target_dir) as entries:
            files = [entry.name for entry in entries] # if entry.is_file()
            return files
        
    except FileNotFoundError:
        from tkinter import messagebox
        messagebox.showerror("Error", ERROR_MSG_)
        return []

其他注意事项 #

• 确保constants.py里的ERROR_MSG_是清晰的提示文本，方便排查问题。
• 打包时在conda环境下运行PyInstaller，确保依赖版本一致。
• MacOS下打包后，若出现安全提示，右键点击生成的可执行文件/app，选择"打开"绕过限制。

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