PyInstaller 打包为 --onefile 可执行文件后出现进程自复制现象，根本原因在于 Windows 平台上 multiprocessing 模块未正确初始化；添加 if __name__ == '__main__': multiprocessing.freeze_support() 可彻底解决该问题。
pyinstaller 打包为 `--onefile` 可执行文件后出现进程自复制现象，根本原因在于 windows 平台上 `multiprocessing` 模块未正确初始化；添加 `if __name__ == '__main__': multiprocessing.freeze_support()` 可彻底解决该问题。
当使用 PyInstaller（尤其是 --onefile 模式）在 Windows 系统上打包含 multiprocessing 或间接依赖多进程的 Python 程序时，若未显式调用 multiprocessing.freeze_support()，Python 解释器在子进程启动时会重新执行主模块（即整个 .py 文件），导致主逻辑被重复运行——表现为程序“自我复制”、界面多次弹出、解压任务反复执行等异常行为。
该问题与您代码中调用 subprocess.Popen 无直接因果关系，但 subprocess 常与 multiprocessing 共存于数据处理脚本中（例如并发解压多个 ZIP 文件），而 pandas、numpy 等科学计算库内部可能隐式触发 multiprocessing（如某些 IO 或并行操作），因此一旦缺失 freeze_support()，就会触发重复执行。
✅ 正确修复方式（必须置于所有重量级模块导入之前）：
import multiprocessing
if __name__ == '__main__':
multiprocessing.freeze_support() # 关键：必须放在 if __name__ == '__main__' 下，且早于 pandas/numpy 等导入
# ✅ 此后方可安全导入其他模块
import os
import subprocess
import pandas as pd
# 其他 import ...
⚠️ 注意事项：
- freeze_support() 仅对 Windows 有效，在 macOS/Linux 上可安全调用但无实际作用；
- 必须严格位于 if __name__ == '__main__': 代码块内，且在任何可能触发多进程的模块（如 pandas, numpy, scipy）导入之前执行；
- 若使用 multiprocessing.Pool 或 Process 显式创建子进程，此调用更是必需；
- 不要将其放在函数内或条件分支外——否则无法拦截子进程的模块重载。
? 额外建议：
为提升健壮性，可在主入口处增加调试标识，确认是否为多进程上下文：
if __name__ == '__main__':
import sys
print(f"[DEBUG] Main process PID: {os.getpid()}, argv[0]: {sys.argv[0]}")
multiprocessing.freeze_support()
打包命令无需修改，仍可使用：
pyinstaller --onefile -w script.py
只要确保 freeze_support() 正确前置，即可杜绝 Windows 下因模块重载导致的“自我复制”，让解压循环、日志写入、GUI 启动等逻辑严格按预期单次执行。
