python -m zipapp 缺模块是因为它不自动收集依赖，只打包当前目录源码和__main__.py；需用pip install --target指定目录安装第三方包，并确保包结构完整、无命名空间包问题。
用 python -m zipapp 打包时为什么缺模块？
直接运行 python -m zipapp myapp 不会自动收集依赖，它只打包当前目录下的源码和 __main__.py。第三方包（比如 requests 或 click）必须显式提供路径或提前安装到临时目录。
常见错误现象：ModuleNotFoundError: No module named 'requests' 运行生成的 .pyz 文件时立刻报错。
- 确保项目已用
pip install -t __pypackages__ .把依赖装进本地目录（__pypackages__是推荐名，可自定义） - 用
-p "python3"指定解释器路径，避免在无环境的机器上启动失败 - 不要依赖
PYTHONPATH或当前site-packages—— zipapp 是隔离的
如何把 venv 里的包一键打进 zipapp？
最稳的方式是先激活虚拟环境，再把 site-packages 整体复制出来，然后用 zipapp 引入该目录。不能直接指定 venv/lib/python3.x/site-packages 路径，因为其中可能含 .so/.dll 或命名空间包，导致解压失败或导入异常。
实操建议：
- 用
pip install --target ./libs -r requirements.txt替代复制 venv，更干净（./libs是纯 Python 包集合） - 确认
./libs下有__init__.py（哪怕空文件）——否则某些包（如importlib_resources）会跳过扫描 - 执行打包命令：
python -m zipapp myapp -o myapp.pyz -p "#!/usr/bin/env python3" -m "myapp.__main__:main" -c，其中-c表示压缩，-m指定入口点
__main__.py 里 import 失败的典型原因
即使依赖已打进 zipapp，运行时仍可能提示 ImportError，根本原因是 Python 的 zipimporter 对包结构敏感：它不支持 PEP 420 命名空间包的隐式发现，也不处理 .dist-info 目录外的元数据。
排查要点：
- 检查
./libs中是否存在重复包（如同时有requests/和requests-2.31.0.dist-info/）——必须成对出现，缺一不可 - 避免使用
pip install --no-deps安装依赖，否则缺失传递依赖（例如urllib3、charset-normalizer） - 如果用了
setuptools风格的entry_points，改用显式函数调用（myapp.__main__:main），别依赖pkg_resources
Windows 上双击运行 zipapp 为什么没反应？
因为 .pyz 文件默认没有注册到系统，双击会尝试用记事本打开，或者静默失败。这不是代码问题，而是操作系统层面的关联缺失。
解决方式有限且需手动：
- 命令行始终可用：
py myapp.pyz或python myapp.pyz（前提是 PATH 里有对应解释器） - 写一个同名的
myapp.bat，内容为@py "%~dp0myapp.pyz" %*，双击它即可 - 不要试图注册
.pyz文件类型——不同 Python 版本对 zipapp 支持程度不同，容易引发兼容性问题
真正跨平台可靠的分发方式，还是得靠明确告知用户“用 python 命令运行”，而不是依赖图形界面交互。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
