如何将基于ttkbootstrap与外部CSV的PyCharm应用转为Windows常规应用

准备工作 #

• 先确认项目能正常运行：在PyCharm中启动main.py，确保应用功能正常
• 激活项目的虚拟环境（或使用已安装所有依赖的Python环境）

使用PyInstaller打包（推荐工具） #

1. 安装PyInstaller
   在终端执行：

   pip install pyinstaller
   

2. 基础打包命令
   切换到项目根目录（和main.py同级的文件夹），执行：

   pyinstaller --onefile --windowed main.py
   

   • --onefile：将所有依赖打包成单个EXE文件
   • --windowed：隐藏命令行窗口（GUI应用必备）
3. 处理资源文件（如assets文件夹内的素材）
   如果项目用到了本地资源，需要通过--add-data参数告诉PyInstaller包含这些文件：

   pyinstaller --onefile --windowed --add-data "assets;assets" main.py
   

   （Windows系统用分号分隔源路径和目标路径）
   若要自定义应用图标，添加--icon=你的图标文件.ico参数即可

找到打包后的应用 #

打包完成后，项目根目录会生成dist文件夹，里面的EXE文件就是可直接运行的桌面应用

常见问题解决 #

• 运行EXE提示缺失模块：确认打包环境已安装所有依赖（比如ttkbootstrap），建议在虚拟环境中完成打包
• 资源文件加载失败：代码中不要用绝对路径引用资源，改用相对路径，示例：

  import os
  resource_path = os.path.join(os.path.dirname(__file__), "assets", "example.png")
  

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