PyCharm+Conda环境下Python代码转EXE失败，求解决方案

问题详情 #

在PyCharm的Conda虚拟环境中编写的PDF处理GUI程序（功能为批量提取PDF倒数第二页并自定义保存文件名）运行完全正常，但使用auto-py-to-exe或PyInstaller打包为EXE文件后，程序无法正常启动或执行功能。

常见故障原因 #

• Conda环境的依赖路径未被PyInstaller正确识别，导致PyPDF2、reportlab等核心库未被打包进EXE
• TKinter的GUI资源文件未被自动包含
• 程序依赖的recent_output_folders.txt文件未被添加到打包资源中
• 打包时未指定GUI程序所需的无终端参数

解决步骤 #

1. 激活Conda环境并更新依赖 #

打开终端，激活你编写代码时使用的Conda环境：

conda activate 你的环境名称

升级所有相关依赖包，避免版本兼容问题：

pip install --upgrade PyPDF2 reportlab pyinstaller

2. 使用PyInstaller命令行打包 #

在代码所在目录执行以下打包命令，覆盖auto-py-to-exe的默认参数：

pyinstaller --onefile --windowed --name PDF_Extractor --add-data "recent_output_folders.txt;." your_script_name.py

参数解释：

• --onefile：生成单个独立的EXE文件
• --windowed：隐藏终端窗口，适合GUI程序运行
• --name：自定义生成的EXE文件名
• --add-data：将recent_output_folders.txt纳入打包资源，程序运行时会自动释放到EXE同目录

3. 修复TKinter依赖缺失问题 #

如果打包后GUI无法显示，添加--hidden-import参数强制包含TKinter：

pyinstaller --onefile --windowed --name PDF_Extractor --add-data "recent_output_folders.txt;." --hidden-import tkinter your_script_name.py

4. 排查运行报错 #

如果EXE仍无法运行，打开终端直接执行EXE文件查看具体错误：

.\dist\PDF_Extractor.exe

根据报错信息，用--hidden-import补充缺失的依赖库（例如--hidden-import PyPDF2）

验证方法 #

1. 进入dist目录运行生成的EXE
2. 选择一个至少包含2页的PDF文件
3. 指定输出文件夹和文件名，检查是否成功生成仅含倒数第二页的PDF

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