Python如何将依赖库打包进zip包运行_实现免安装的绿色版程序-Python教程-PHP中文网

zipapp可将纯Python项目打包为单个.pyz文件直接运行，但不支持含C扩展的依赖（如numpy、pillow），此时应改用PyInstaller等工具。

python如何将依赖库打包进zip包运行_实现免安装的绿色版程序

用 `zipapp` 打包成单个 zip 文件，直接 `python app.zip` 运行

Python 3.7+ 自带 zipapp 模块，能将脚本 + 依赖（纯 Python 库）打包进一个 zip 文件，无需安装依赖、不污染系统环境。关键前提是：所有依赖必须是纯 Python 的，不能含 C 扩展（如 numpy、pillow、cryptography 等）。否则运行时会报 ModuleNotFoundError 或 ImportError: No module named '_cffi_backend' 这类错。

实操步骤：

先用 pip install --target ./pkg_deps -r requirements.txt 把依赖装到本地目录（注意：不要用 --user 或全局 site-packages）
把主脚本（如 main.py）和 pkg_deps/ 目录一起塞进 zip：python -m zipapp myapp -m "main:main" -p "/usr/bin/env python3"
-m "main:main" 表示入口是 main.py 里的 main() 函数；-p 指定 shebang，Linux/macOS 下双击或直接执行才有效
生成的 myapp.pyz 就是可执行 zip 包，python myapp.pyz 即可运行

遇到 C 扩展依赖时，`PyInstaller` 是更现实的选择

zipapp 对 pyd/so 文件无能为力。一旦 requirements.txt 里有 requests（底层用 urllib3 和 chardet，纯 Python）还行，但加了 psycopg2 或 pydantic（v2 起默认用 pydantic-core C 扩展）就必然失败。

这时得切到 PyInstaller：

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

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

下载

用虚拟环境隔离：python -m venv venv && venv/bin/pip install -r requirements.txt（Windows 用 venv\Scripts\pip）
运行 venv/bin/python -m PyInstaller --onefile --console main.py（--console 保留终端输出，GUI 程序换 --windowed）
输出在 dist/main（无后缀）或 dist/main.exe，它本质是自解压 + 启动器，内部已嵌入 Python 解释器副本和所有依赖
注意：生成的文件不是 zip，是二进制可执行文件，但效果等同“绿色版”——扔到任意同架构机器上就能跑

`pip install --root` + 手动 zip 不推荐，容易漏文件或路径错

有人试过用 pip install --root ./bundle -t ./bundle/lib/python3.x/site-packages -r requirements.txt，再把脚本和 site-packages 打包，最后写个 shell/bat 启动。这条路理论上可行，但实际踩坑密集：

--root 不处理依赖的 data_files（比如 certifi 的证书目录、click 的补全脚本），运行时报 FileNotFoundError: [Errno 2] No such file or directory: 'cacert.pem'
不同平台的 .pth 文件、__pycache__、pyd/so 的 ABI 标签（如 cp39-cp39-manylinux_2_17_x86_64）必须严格匹配目标环境，手动凑极易出错
启动脚本要硬编码 Python 解释器路径或用相对路径找 python，跨机器时经常找不到解释器

最终选型关键看依赖成分，不是看“是否 zip”

真正决定能不能做成免安装绿色版的，从来不是打包格式，而是依赖里有没有非纯 Python 组件。如果项目只用 requests、pyyaml、click 这类，zipapp 快、轻、透明；一旦引入 numpy、pandas、opencv-python 或任何带 setup.py 且调用 setuptools 编译的库，PyInstaller 或 cx_Freeze 就是唯一靠谱路径。