Windows下PyInstaller构建qrTransfer失败，argparse报SystemExit:2

问题本质 #

你的报错是因为PyInstaller在Windows打包后启动子进程时，会传递窗口尺寸参数（即报错里的732、824），而这些参数被你的脚本argparse解析器当成了未定义的命令行参数，直接触发了SystemExit:2错误。Linux环境下PyInstaller的参数传递逻辑不同，所以未出现该问题。

分步解决方案 #

1. 过滤PyInstaller的内部参数 #

在argparse解析前，先剔除掉可能是窗口尺寸的纯数字参数，避免被误解析：

import sys
import argparse

def main():
    # 过滤掉PyInstaller传递的纯数字窗口参数
    filtered_args = [arg for arg in sys.argv[1:] if not arg.isdigit()]
    
    # 你的原有argparse配置
    parser = argparse.ArgumentParser(description='二维码跨设备文件传输工具')
    # 示例配置，替换成你实际的参数定义
    # parser.add_argument('--port', type=int, default=8080, help='服务端口')
    # parser.add_argument('--debug', action='store_true', help='开启调试模式')
    
    args = parser.parse_args(filtered_args)
    # 后续业务逻辑代码

if __name__ == '__main__':
    main()

2. 调整PyInstaller打包参数 #

如果你的项目是GUI程序，打包时添加--noconsole参数，彻底避免PyInstaller传递控制台窗口尺寸参数：
修改你的build.bat脚本：

@echo off
pyinstaller --noconsole --onefile --name qrTransfer your_main_script.py
pause

如果需要保留控制台，可在生成的.spec文件中禁用argv模拟：

# 在.spec文件的EXE配置段添加argv_emulation=False
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          a.zipfiles,
          a.datas,
          [],
          name='qrTransfer',
          console=True,
          argv_emulation=False,  # 关键配置
          upx=True,
          debug=False)

3. 降级PyInstaller版本 #

既然一年半前Windows构建正常，说明新版本PyInstaller的参数传递逻辑有变更，可尝试降级到旧稳定版：

pip uninstall pyinstaller -y
pip install pyinstaller==4.10

4. 排查argparse配置冲突 #

检查你的argparse是否定义了位置参数（无--前缀的参数），这类参数会优先匹配PyInstaller传递的数字，导致解析错误。建议将所有参数改为带--前缀的可选参数。

验证流程 #

1. 直接在Windows下运行脚本，确认脚本本身无运行错误
2. 用修改后的argparse逻辑重新打包
3. 若仍失败，尝试降级PyInstaller版本后再次构建

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