使用多进程与PyInstaller打包exe时Argparse报错问题

这个问题我之前也踩过坑，本质是Windows系统下multiprocessing的spawn启动机制和PyInstaller打包后的执行逻辑冲突导致的：

问题根源 #

在Windows上，multiprocessing默认用spawn方式创建子进程，这会重新加载你的主脚本模块并执行模块顶层的所有代码——包括你写在if __name__ == "__main__"之外的argparse解析逻辑。当子进程启动时，它没有收到任何命令行参数，所以ap.parse_args()会直接抛出“缺少必需参数”的错误，也就是你看到的main.exe: error: the following arguments are required: -a/--faces, -d/--csv。

解决方案：调整代码结构 #

核心思路是把命令行参数解析逻辑放到if __name__ == "__main__"代码块内部，让子进程启动时不会执行这部分代码，同时直接将解析好的参数传递给子进程的函数，而不是让子进程自己去解析命令行。

修改后的代码示例：

import argparse
import multiprocessing

def main(csv, faces):
    # 这里写你的原有业务逻辑
    print(f"处理CSV: {csv}, 人脸文件夹: {faces}")

if __name__ == "__main__":
    multiprocessing.freeze_support()
    
    # 仅在主进程中解析命令行参数
    ap = argparse.ArgumentParser()
    ap.add_argument("-a", "--faces", required=True, help="Folder path of known faces to find")
    ap.add_argument("-d", "--csv", required=True, help="Use CSV to provide training images?")
    args = vars(ap.parse_args())
    
    # 启动子进程时，直接传递解析好的参数
    # 示例：启动单个子进程
    child_process = multiprocessing.Process(
        target=main,
        args=(args['csv'].lower(), args['faces'])
    )
    child_process.start()
    child_process.join()
    
    # 如果用Pool批量启动进程，也是直接传参数
    # with multiprocessing.Pool() as pool:
    #     pool.apply(main, args=(args['csv'].lower(), args['faces']))

额外注意事项 #

1. 打包时确保使用正确的PyInstaller命令，比如单文件打包：

pyinstaller --onefile your_script_name.py

2. 不要在模块顶层（if __name__块之外）放任何会触发命令行交互、依赖外部输入的代码，子进程启动时都会重新执行这些逻辑。

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