如何用PyInstaller将含多子进程的Python文件打包为单个.exe

我之前处理过类似的场景，PAGE生成的GUI配合子进程避免卡顿，打包成单exe确实需要注意几个关键点，下面分两种可行方案详细说明：

方案一：将子脚本作为资源打包，通过主exe调用 #

这种方案适合你不想改动太多子脚本代码的情况，核心是让PyInstaller把所有子脚本包含进去，并在运行时找到它们的正确路径。

1. 完善资源路径函数 #

首先确保你resource_path函数能正确获取PyInstaller临时目录下的文件，补充完整：

import os
import sys

def resource_path(relative_path):
    try:
        # PyInstaller打包后会把资源解压到这个临时目录
        base_path = sys._MEIPASS
    except Exception:
        # 开发环境下用当前目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

2. 修改subprocess调用逻辑 #

调用子脚本时，不要直接用python script.py，而是用当前运行的主exe（sys.executable）来执行子脚本，因为打包后的exe本身包含了Python运行环境：

import subprocess

def run_script(script_name):
    script_path = resource_path(script_name)
    # 创建子进程，可选隐藏控制台窗口
    process = subprocess.Popen(
        [sys.executable, script_path],
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        creationflags=subprocess.CREATE_NO_WINDOW  # Windows下有效
    )
    # 注意：不要直接用process.wait()，否则会阻塞主GUI
    # 可以用线程来读取输出，示例：
    import threading
    def read_output(proc):
        stdout, stderr = proc.communicate()
        # 这里可以处理输出，比如显示到GUI日志框
        print(stdout.decode(), stderr.decode())
    threading.Thread(target=read_output, args=(process,), daemon=True).start()
    return process

3. 打包时包含子脚本 #

用PyInstaller命令行打包时，通过--add-data参数把所有子脚本添加进去（Windows下用;分隔，Linux/macOS用:）：

pyinstaller --onefile --add-data "script1.py;." --add-data "script2.py;." --add-data "script3.py;." --add-data "script4.py;." Main.py

或者修改生成的.spec文件，在datas列表中添加子脚本：

a = Analysis(
    ['Main.py'],
    datas=[('script1.py', '.'), ('script2.py', '.'), ('script3.py', '.'), ('script4.py', '.')],
    # 其他参数...
)

方案二：将子脚本逻辑整合到主程序（更简洁） #

如果愿意调整代码结构，这种方案更高效，不用单独打包子脚本，所有逻辑都在一个exe里：

1. 整合子脚本代码到Main.py #

把每个子脚本的代码封装成函数，放到Main.py中：

def run_script1():
    # 原来script1.py的所有代码逻辑
    print("执行脚本1")
    # ...

def run_script2():
    # 原来script2.py的所有代码逻辑
    print("执行脚本2")
    # ...

2. 添加命令行参数分支 #

在Main.py的入口处，处理命令行参数，判断是否要执行子脚本逻辑：

if __name__ == "__main__":
    import sys
    # 检查是否是子进程调用（带脚本参数）
    if len(sys.argv) > 1:
        if sys.argv[1] == "--run-script1":
            run_script1()
            sys.exit(0)
        elif sys.argv[1] == "--run-script2":
            run_script2()
            sys.exit(0)
        # 其他脚本同理
    # 否则启动主GUI
    # 原来PAGE生成的GUI初始化代码，比如：
    # from tkinter import *
    # root = Tk()
    # ...

3. 修改subprocess调用 #

直接调用主exe并传递对应参数：

def run_script(script_flag):
    process = subprocess.Popen(
        [sys.executable, script_flag],
        creationflags=subprocess.CREATE_NO_WINDOW
    )
    # 同样用线程处理输出，避免阻塞GUI
    # ...

比如调用脚本1时：run_script("--run-script1")

4. 打包 #

这种情况下只需打包Main.py即可，不用添加额外的子脚本：

pyinstaller --onefile Main.py

关键注意事项 #

• 避免GUI阻塞：一定要用线程处理子进程的输出，不要直接调用communicate()或wait()，否则主GUI会卡住。
• 资源路径一致性：如果子脚本中用到了其他资源（比如图片、配置文件），也要用同样的resource_path函数获取路径，不然打包后找不到。
• 隐藏控制台窗口：如果你的GUI是无控制台的，打包时加上--windowed参数，同时子进程用CREATE_NO_WINDOW避免弹出额外窗口。
• 测试打包后的程序：打包后要在干净的环境测试，确保子进程能正常执行，路径没有问题。

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