如何将Python脚本打包为无编程基础用户可正常打开的文件

先定位无提示启动失败的根因 #

不要盲目换方案，先拿到实际报错再针对性处理：

• 找测试用户不要直接双击exe，让对方打开命令提示符（cmd），把生成的exe文件拖进cmd窗口后按回车运行，所有崩溃的错误信息会直接打印在命令行窗口，不需要靠猜定位问题
• 这类无任何报错的启动失败，90%以上是以下三类原因：
  • 打包参数错误：使用单文件（--onefile）模式打包时，PyInstaller没有自动收集到qrcode、PIL、tkinter的隐式依赖，运行时临时资源解压失败直接闪退
  • 缺少系统运行库：PyInstaller打包的程序依赖Microsoft Visual C++ Redistributable运行库，很多纯净版、精简版Windows系统默认没有安装对应版本，程序启动时直接被系统拦截
  • 杀毒软件误杀：单文件exe启动时会自动解压资源到系统临时目录，行为和很多恶意程序高度相似，会被Windows Defender或第三方杀毒软件静默拦截，不会弹出任何提示

可落地的分发方案（按实现成本从低到高排序） #

方案1：修正PyInstaller打包配置，解决兼容问题 #

不需要改现有代码，调整打包参数即可：

• 放弃默认的单文件打包模式，选择--onedir文件夹模式打包，打包完成后把整个生成的输出文件夹压缩成zip发给用户，用户解压后点击内部的exe即可运行。这种模式启动速度更快，被杀毒误报的概率比单文件模式低60%以上
• 打包时显式声明所有隐式依赖，不要靠工具自动识别，基础打包命令参考：

pyinstaller --noconfirm --windowed --onedir --name "联系二维码生成工具" --hidden-import qrcode --hidden-import PIL --hidden-import tkinter 你的脚本文件名.py

• 打包完成后不要直接在自己的开发机上测试，把输出文件夹拷到没有安装Python、没有装开发运行库的纯净Windows虚拟机里跑，确认能正常启动再分发
• 给用户的压缩包内提前放好对应版本的VC运行库安装包，加1行纯文本说明：如果双击exe没反应，先运行VC运行库安装包，再把整个解压后的文件夹加到杀毒软件信任区

方案2：换编译型打包工具，降低兼容问题概率 #

如果PyInstaller始终存在兼容、误报问题，换Nuitka打包：

• Nuitka会把Python代码直接编译为原生C级别的可执行文件，不是PyInstaller那种“打包解释器+源码”的模式，生成的exe启动速度更快，被杀毒误报的概率极低，系统兼容度更好
• 基础打包命令参考：

nuitka --standalone --windows-disable-console --enable-plugin=tk-inter --include-package=qrcode --include-package=PIL 你的脚本文件名.py

方案3：零兼容问题的无打包方案 #

如果不想反复折腾打包兼容问题，直接把工具做成单HTML文件：

• 可以用前端JS的二维码生成库实现完全一样的功能，整个工具只有一个独立的.html文件，用户不管用Windows、Mac系统，双击文件就能用默认浏览器打开，输入信息后一键生成二维码保存到本地，完全不需要安装任何软件、不存在系统兼容问题、不会被杀毒软件误报，对零技术基础的用户门槛比exe更低

如果不想重写现有Python逻辑，也可以用PyScript把现有Python代码直接嵌入到HTML文件中，不需要编写JS代码，用户打开HTML文件就能直接在浏览器里运行Python逻辑，不需要本地安装Python环境

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