CustomTkinter程序打包后InstallForge制作的安装包无法在其他电脑运行

核心问题定位 #

CustomTkinter依赖额外的主题、图标等资源文件，若打包或安装包制作时未正确包含这些文件，就会导致非开发环境无法启动程序。

具体解决步骤 #

1. 重新用auto-py-to-exe打包，确保依赖全包含 #

• 打开auto-py-to-exe，切换到Additional Files选项卡，点击Add Folder，手动添加Python环境下的Lib/site-packages/customtkinter整个文件夹
• 优先选择One Directory打包模式，这种模式下能直观看到所有依赖文件，便于排查缺失项

2. 修正安装包的文件配置 #

• 不管用InstallForge还是Inno Setup，必须把打包生成的整个目录（含.exe、customtkinter文件夹、其他依赖文件）全部添加到安装包，不能只单独添加.exe
• 安装路径避开Program Files这类需要系统权限的目录，默认选{userprofile}\AppData\Local\你的程序名，或让用户自定义到非系统盘目录

3. 抓取运行时错误信息 #

• 让朋友在程序安装目录下，按住Shift+右键打开PowerShell窗口，直接运行.exe文件，查看控制台输出的具体错误（比如“缺失xxx.dll”“找不到主题文件”）
• 若提示VC++运行库缺失，让朋友安装对应位数的微软VC++ Redistributable（和你打包用的Python位数一致）

4. 版本兼容性检查 #

• 确保你打包用的Python版本位数（32/64位）和朋友的系统位数匹配
• 升级CustomTkinter到最新稳定版，避免旧版本的兼容bug

额外测试建议 #

• 用pyinstaller命令行打包，比图形化工具更透明：

  pyinstaller --onefile --windowed --add-data "Lib/site-packages/customtkinter;customtkinter" 你的脚本名.py
  

• 找一台未安装Python的干净电脑或虚拟机测试安装包，模拟朋友的环境

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