zipapp可将纯Python项目打包为单个.pyz文件直接运行，但不支持含C扩展的依赖（如numpy、pillow），此时应改用PyInstaller等工具。
用 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：
立即学习“Python免费学习笔记（深入）”；
- 用虚拟环境隔离：
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 就是唯一靠谱路径。
别被“zip 包”这个形式迷惑——用户要的是“复制即用”，而 Python 生态里，C 扩展的存在让真正的“纯 zip 绿色版”成了窄门。
