PyInstaller打包Python为.exe触发WinError225病毒误报问题咨询

问题情况 #

执行打包命令：

pyinstaller --onefile -w q2.py

触发杀毒软件误判，核心报错：

OSError: [WinError 225] Operation did not complete successfully because the file contains a virus or potentially unwanted software.

实际设备无病毒，属于安全软件对PyInstaller生成文件的误识别。

解决步骤 #

• 临时添加信任/关闭实时防护
  将PyInstaller安装目录、当前项目的dist/build文件夹加入Windows Defender或第三方杀毒软件的白名单，或临时关闭实时保护，完成打包后再恢复防护。

• 调整打包参数

  • 放弃单文件模式，生成文件夹格式程序，大幅降低误报概率：

    pyinstaller -w q2.py
    

  • 禁用UPX压缩（压缩后的文件易被杀毒软件标记）：

    pyinstaller --onefile -w --noupx q2.py
    

• 更换PyInstaller版本
  部分新版本PyInstaller的bootloader易被误判，尝试降级到稳定旧版本：

  pip uninstall pyinstaller -y
  pip install pyinstaller==5.13.2
  

• 替换签名版bootloader
  把本地PyInstaller的bootloader替换为官方签名版本，签名文件更难被误识别，替换路径一般为：Python安装目录\Lib\site-packages\PyInstaller\bootloader\Windows-64bit-intel\

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