Pyinstaller打包的exe本地运行正常 其他Win10设备运行报错如何解决

常见原因及对应解决方法 #

• 运行时依赖库遗漏
  开发环境预装了项目所需的所有Python依赖库，而PyInstaller仅会自动识别显式导入的模块，若代码存在动态导入（__import__、importlib相关导入逻辑）、第三方库隐式依赖的组件，都会出现打包后依赖缺失的问题。建议先在目标设备上通过命令行启动exe文件（而非双击运行），读取完整错误堆栈定位缺失的模块，打包时通过--hidden-import [缺失模块名]参数手动指定导入。
• VC运行库缺失
  大部分Python二进制扩展包（如GUI框架、数值计算库）依赖对应版本的Microsoft Visual C Redistributable运行库，开发机因安装开发环境默认预装该组件，纯净的用户设备大概率未安装。可根据你打包使用的Python版本，给目标设备安装对应版本的VC运行库（Python3.5及以上版本对应VC2015-2022版）。
• 硬编码路径问题
  若代码中写死了开发环境的绝对路径（如你本地的C:/gui/exe/路径），目标设备不存在该路径时会直接触发报错。建议将代码中所有资源引用改为基于exe运行目录的相对路径，打包时通过--add-data参数将依赖的静态资源（图标、配置文件等）一同打包进程序。
• 系统环境差异
  若开发机Windows系统版本高于目标设备，或打包路径存在中文、特殊字符，也可能触发兼容性问题。可尝试右键exe打开属性，勾选兼容模式运行；打包时选择无中文、无空格的目录执行打包命令。

调整后参考打包命令 #

pyinstaller --noconfirm --onedir --windowed --icon "C:/gui/exe/stopwatch.ico" --exclude-module _bootlocale --hidden-import [你定位到的缺失模块] --add-data "C:/gui/exe/stopwatch.ico;." "C:/gui/exe/rt50.py"

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