Pyinstaller单文件打包程序崩溃时残留临时文件如何自动清理？

问题本质 #

PyInstaller单文件模式的自动清理逻辑仅绑定在程序正常退出的钩子上，只要出现强制杀进程、程序崩溃、命令行被强制关闭的情况，退出钩子不会触发，解压生成的临时文件夹必然残留，修改--runtime-tmpdir参数仅能改变临时文件存放路径，无法修复异常退出时钩子不执行的原生机制问题。

可落地方案 #

1. 内置启动阶段自清理逻辑（最稳定，推荐） #

在程序代码最入口位置加入前置清理逻辑，程序每次启动时自动扫描对应临时目录，删除历史残留的旧_MEI文件夹，全程不需要用户手动操作，也不依赖系统清理规则。

• 核心判断逻辑：
  • 仅在打包后的运行状态执行清理，开发调试态直接跳过
  • 自动跳过本次程序运行正在使用的_MEI文件夹（路径存放在sys._MEIPASS变量中）
  • 遇到其他正在运行的PyInstaller程序占用的_MEI文件夹自动跳过，不会影响其他程序运行
• 可直接复用的代码（全用Python标准库，无额外依赖）：

import sys
import os
import shutil
import glob
from tempfile import gettempdir

def cleanup_stale_mei():
    # 非打包运行状态不执行清理
    if not getattr(sys, 'frozen', False):
        return
    # 临时目录根路径：如果用--runtime-tmpdir指定了专属路径，把下面这行换成你指定的绝对路径即可
    tmp_base = gettempdir()
    # 当前程序正在使用的临时文件夹路径
    current_mei = os.path.normpath(sys._MEIPASS)
    # 扫描所有符合_MEI开头命名规则的文件夹
    for mei_folder in glob.glob(os.path.join(tmp_base, "_MEI*")):
        mei_folder_norm = os.path.normpath(mei_folder)
        if mei_folder_norm == current_mei:
            continue
        # 静默删除历史残留文件夹，遇到占用/权限问题直接跳过
        shutil.rmtree(mei_folder_norm, ignore_errors=True)

# 程序入口第一时间执行清理
if __name__ == "__main__":
    cleanup_stale_mei()
    # 后续接原有业务逻辑

2. 配合--runtime-tmpdir指定专属临时目录（避免污染系统临时文件夹） #

如果不想让程序临时文件散落在系统默认临时目录，可以在打包时通过--runtime-tmpdir参数指定程序专属的临时路径，建议选在当前用户默认有读写权限的位置：

• Windows下可设为exe同目录下的./tmp子文件夹
• Linux/macOS下可设为~/.cache/你的程序名/tmp
  指定专属路径后，上面的清理代码只需要把tmp_base变量改成对应路径即可，清理范围更精准，也不会误扫其他PyInstaller程序生成的临时文件。

注意：不要把临时目录设在需要管理员权限的路径下（比如Windows的C:\Program Files目录），否则普通权限运行时会出现读写、删除失败的问题。

3. 无代码修改的替代方案（不推荐） #

如果不想修改程序源码，可以写一个外置启动脚本（Windows用bat、Linux/macOS用sh），脚本启动前先删除对应临时目录下的旧_MEI文件夹，再启动主程序。但这个方案的缺陷是用户如果直接双击exe运行、不通过脚本启动，清理逻辑就不会生效。

常见误区 #

• 打包时加--clean参数无法解决运行时残留：该参数仅会清理打包过程中生成在本地的临时文件，和终端用户运行程序时产生的临时文件没有关系。
• 依赖系统自带的临时文件清理策略不可控：不同操作系统的临时文件清理周期不固定，Windows默认可能超过30天未访问才会清理，Linux部分发行版甚至不会自动清理/tmp下的文件。

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