PyInstaller打包前后进程行为差异问题及实现咨询

问题根源 #

PyInstaller打包后的可执行文件与Python脚本的多进程执行逻辑存在差异：

• 脚本运行时，multiprocessing.Process会创建子进程并仅执行指定的target函数。
• 打包后，子进程启动时会重新执行整个可执行文件的入口逻辑，导致if __name__ == '__main__':中的代码被重复触发，进而无限循环启动新进程，也就是你看到的重复输出“Starting of the program ...”。

同时你代码中使用的newProcess.join()会阻塞原进程等待子进程结束，这不符合“关闭原会话不终止新会话”的需求。

修复后的示例代码 #

以下代码适配PyInstaller打包规则，同时满足独立会话的需求：

import time
from random import random
from multiprocessing import Process, freeze_support

# 模拟QMainWindow类
class Foo():
    def __init__(self, new_foo_func, previous_rand=None) -> None:
        self.new_foo_func = new_foo_func
        self.rand_num = random()
        print(f'Random number of this foo: {self.rand_num}')
        print(f'Random number of previous foo: {previous_rand}')

        time.sleep(2)
        print('Trying to start a new foo')
        self.startNewFoo()
    
    def startNewFoo(self):
        self.new_foo_func(self.rand_num)

def newFooFunc(previous_rand):
    Foo(newFooProc, previous_rand)
    
def newFooProc(previous_rand=None):
    # 移除join()，让子进程独立运行，原进程关闭不影响它
    newProcess = Process(target=newFooFunc, args=(previous_rand,))
    newProcess.start()

if __name__ == '__main__':
    # 必须添加freeze_support()，适配PyInstaller打包后的多进程逻辑
    freeze_support()
    print('Starting of the program ...')
    # 直接初始化Foo，简化嵌套调用逻辑
    Foo(newFooProc)

关键改动说明 #

• 添加freeze_support()：这是PyInstaller打包多进程程序的必备步骤，它会处理打包后子进程的启动逻辑，避免重复执行主入口代码。
• 移除join()：join()会阻塞原进程等待子进程结束，移除后子进程会独立运行，关闭原进程不会终止子进程。
• 修正args参数：原代码中args=([previous_rand])是错误写法，应改为args=(previous_rand,)（元组形式，末尾逗号不能省略），否则会把列表作为单个参数传递给目标函数。

更适合PyQt场景的替代方案 #

对于PyQt启动独立会话的需求，直接用subprocess.Popen启动当前可执行文件的新实例并传递命令行参数会更简洁可靠，完全规避multiprocessing的打包兼容问题：

import sys
import subprocess
from PyQt5.QtWidgets import QMainWindow, QPushButton, QApplication

class MainWindow(QMainWindow):
    def __init__(self, save_dir=None, window_pos=None):
        super().__init__()
        self.save_dir = save_dir
        self.window_pos = window_pos
        if window_pos:
            self.move(*window_pos)
        
        self.btn_new_session = QPushButton("启动新会话", self)
        self.btn_new_session.clicked.connect(self.start_new_session)
        self.setGeometry(100, 100, 300, 200)
    
    def start_new_session(self):
        # 获取当前可执行文件路径
        exe_path = sys.executable if getattr(sys, 'frozen', False) else sys.argv[0]
        # 传递参数：当前窗口位置、保存目录
        args = [exe_path, f"--pos={self.x()},{self.y()}", f"--save-dir={self.save_dir or 'default'}"]
        # 启动完全独立的新进程
        subprocess.Popen(args, start_new_session=True)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    # 解析命令行参数
    save_dir = None
    window_pos = None
    for arg in sys.argv[1:]:
        if arg.startswith('--save-dir='):
            save_dir = arg.split('=')[1]
        elif arg.startswith('--pos='):
            x, y = map(int, arg.split('=')[1].split(','))
            window_pos = (x, y)
    window = MainWindow(save_dir, window_pos)
    window.show()
    sys.exit(app.exec_())

这种方式的优势：

• 彻底避免multiprocessing与PyInstaller的兼容性问题。
• 新会话是完全独立的进程，关闭原程序不会影响它。
• 通过命令行参数传递窗口位置、保存目录等信息，逻辑清晰易维护。

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