PyInstaller 打包为 --onefile 可执行文件后出现进程自我复制（多次启动），根本原因在于 Windows 平台上 multiprocessing 模块未正确初始化，需在导入重型模块前显式调用 multiprocessing.freeze_support()。
pyinstaller 打包为 `--onefile` 可执行文件后出现进程自我复制（多次启动），根本原因在于 windows 平台上 multiprocessing 模块未正确初始化，需在导入重型模块前显式调用 `multiprocessing.freeze_support()`。
当使用 PyInstaller 的 --onefile 模式打包 Python 程序（尤其是含 subprocess 或隐式依赖 multiprocessing 的脚本）时，在 Windows 系统上常出现主进程被意外多次触发的现象——看似“程序自我复制”，实则是子进程启动机制与冻结环境不兼容所致。典型诱因是：未在 if __name__ == '__main__': 块中调用 multiprocessing.freeze_support()，而该函数是 PyInstaller 官方明确要求的 Windows 多进程支持前置步骤。
虽然你的代码中未显式使用 multiprocessing，但以下情况仍会间接触发其行为：
- pandas、numpy 等科学计算库在底层可能启用多进程加速（如某些 IO 或并行操作）；
- subprocess.Popen 本身虽不依赖 multiprocessing，但在 --onefile 模式下，PyInstaller 运行时会临时解压并重定向入口，若 multiprocessing 初始化缺失，Windows 的 spawn 启动方式将导致主模块被重复导入执行。
✅ 正确修复方式（必须严格按顺序）：
# ✅ 第一步：仅导入轻量级内置模块（如 os, sys, multiprocessing）
import multiprocessing
import sys
# ✅ 第二步：在入口点显式调用 freeze_support()
if __name__ == '__main__':
multiprocessing.freeze_support() # ← 关键！必须在此处且仅一次
# ✅ 第三步：再导入 pandas、subprocess、os 等重型模块
import os
import subprocess
import pandas as pd
⚠️ 注意事项：
- freeze_support() 必须位于 if __name__ == '__main__': 内部，且必须在任何可能触发 multiprocessing 的模块（如 pandas）导入之前调用；
- 不要将其放在函数内或条件分支外，否则无法生效；
- 若使用 pyinstaller --onedir，此问题通常不出现，但 --onefile 下绝对必要；
- 验证是否生效：打包后运行任务管理器，观察进程树——正常应仅有一个 script.exe 主进程，而非多个同名实例。
? 补充建议：
为增强健壮性，可在 subprocess.Popen 后添加超时控制与异常捕获，避免因解压卡死导致后续逻辑异常：
try:
result = subprocess.run(
[program, "x", "-y", f"-p{password_customer}", file_path, f"-o{data_analysis_folder}"],
stdout=subprocess.DEVNULL,
stderr=subprocess.PIPE,
timeout=300 # 5分钟超时
)
if result.returncode != 0:
errors.append(f"Error extracting {zip_file}: {result.stderr.decode('utf-8')}")
except subprocess.TimeoutExpired:
errors.append(f"Timeout extracting {zip_file}")
遵循上述结构与规范，即可彻底解决 PyInstaller --onefile 打包后进程重复启动的问题，确保生成的 EXE 行为与原始脚本完全一致。
