如何将Python脚本打包为可独立运行的单文件Windows可执行程序

问题根本原因 #

你遇到的现象本质是PyInstaller自动打包时未捕获全部隐式依赖：

• Fortran编译的自定义包依赖的运行时库（如libgfortran、libgcc等）未被打包
• matplotlib的后端文件、资源文件被遗漏
• Anaconda提示符自带了依赖库的路径映射，所以在其中运行能找到对应文件，而双击运行时系统无对应路径配置，导致程序启动失败

操作步骤 #

1. 准备干净的打包环境 #

不要直接使用Anaconda base环境打包，先创建一个最小化的虚拟环境：

• 用Python官方venv或者conda创建仅包含必要依赖的环境
• 依次安装numpy、matplotlib、你的自定义Fortran包、pyinstaller

2. 先生成目录版包排查依赖 #

先不加--onefile参数打包，方便排查缺失文件：
pyinstaller myprogram.py
打包完成后进入dist/myprogram目录，在无Python/Anaconda的干净环境（如Windows沙盒）中运行目录内的exe，记录报错提示的缺失dll、模块。

3. 修改打包配置spec文件 #

首次运行PyInstaller后会在脚本同目录生成myprogram.spec文件，按以下规则修改：

• 在文件头部引入matplotlib：import matplotlib
• 在Analysis的hiddenimports参数中补充遗漏的模块：

  hiddenimports=['matplotlib.backends.backend_tkagg', '你的自定义Fortran包名']
  

• 在binaries参数中补充你排查到的缺失dll，格式为(本地dll路径, 打包后存放路径)：

  binaries=[
      ('C:/path/to/libgfortran-5.dll', '.'),
      ('C:/path/to/你的自定义包依赖的其他.dll', '.')
  ]
  

• 在datas参数中补充matplotlib资源文件：

  datas=[(matplotlib.get_data_path(), 'mpl-data')]
  

4. 用spec重新打包单文件exe #

执行以下命令基于修改后的spec文件打包：
pyinstaller --onefile myprogram.spec

额外注意事项 #

• 打包过程中关闭杀毒软件，避免依赖文件被拦截导致打包不全
• 如果你的GUI基于tkinter开发，确保虚拟环境中已安装tkinter组件
• 最终测试必须在无Python/Anaconda环境的设备上完成，避免本地环境的路径干扰
• Fortran包依赖的运行时库优先从你编译Fortran代码的环境中拷贝，不要直接拷贝Anaconda目录下的dll，避免版本不兼容

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