要用 PyInstaller 打包出真正的单个 EXE 文件，必须使用 --onefile 参数，并处理隐式导入、资源路径（通过 resource_path() 函数）和第三方库兼容性问题。

如何用python pyinstaller将脚本打包成独立的exe执行文件？

PyInstaller 能把 Python 脚本打包成单个 exe 文件，但默认生成的是带依赖目录的“目录模式”，想真·单文件必须加 --onefile 参数，且得提前处理好路径、资源、第三方库兼容性问题。

怎么用 PyInstaller 打包出真正的单个 EXE 文件？

默认运行 pyinstaller script.py 会生成 dist/script/ 目录，里面包含 script.exe 和一堆 DLL、pyd 文件——这不是单文件。要真正打包成一个 .exe，必须显式加 --onefile：

pyinstaller --onefile script.py
加 --console（或 --noconsole）控制黑窗口是否显示，GUI 程序通常要 --noconsole
加 --icon=icon.ico 可指定图标，注意路径必须存在且是 .ico 格式
加 --name=myapp 可重命名输出的 EXE 文件名

打包后，最终产物只有一个 dist/myapp.exe（Windows 下），但要注意：它启动时仍会临时解压到 %TEMP%/_MEIxxx/ 目录，这是正常行为，不是失败。

打包后运行报错 “ModuleNotFoundError” 或找不到模块怎么办？

PyInstaller 不会自动分析动态导入（比如 importlib.import_module、__import__）、字符串形式的模块名，或某些包内隐藏的子模块（如 pkg_resources、matplotlib 的后端）。常见现象是 EXE 运行时报 ModuleNotFoundError: No module named 'xxx'。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

用 --hidden-import=xxx 显式声明缺失模块，例如：pyinstaller --onefile --hidden-import=pkg_resources --hidden-import=matplotlib.backends.backend_tkagg script.py
对使用了 importlib 动态加载的模块，最好在代码里加 dummy import（哪怕不调用），让 PyInstaller 能静态扫描到
某些包（如 openpyxl、scipy）自带 hook，但版本更新后可能失效，可查 site-packages/pyinstaller/hooks/ 看是否有对应 hook-xxx.py

打包后读取数据文件或资源失败，路径怎么写才对？

脚本开发时用 os.path.join(os.path.dirname(__file__), "data.csv") 是 OK 的，但打包成 --onefile 后，__file__ 指向的是临时解压路径（类似 C:\Users\...\AppData\Local\Temp\_MEIxxx\script.py），而资源文件并不在那——它们被一起打包进 EXE，运行时需用 PyInstaller 提供的 _MEIPASS 机制定位。

统一用这个函数获取资源根路径：

import sys
import os
<p>def resource_path(relative_path):
"""获取资源文件绝对路径，兼容开发环境和打包后"""
if getattr(sys, 'frozen', False):</p><h1>打包后的路径</h1><pre class="brush:python;toolbar:false;">    base_path = sys._MEIPASS
else:
    # 开发时路径
    base_path = os.path.abspath(".")
return os.path.join(base_path, relative_path)