不能直接运行，但可通过导入后执行；zipimport 使 ZIP 成为 sys.path 条目以支持 import，需手动调用模块函数，不自动触发 if __name__ == '__main__':。
zipimport 能直接运行 zip 包里的 .py 文件吗？
不能直接“运行”，但可以导入并执行——zipimport 的核心能力是让 Python 把 zip 文件当作一个可搜索的 sys.path 条目，从而支持 import。你写不了 python myapp.zip 这种命令，但可以 python -c "import main; main.run()"，前提是 main.py 在 zip 根目录或合法包结构里。
常见错误现象：ModuleNotFoundError: No module named 'xxx'，往往是因为 zip 内部路径没对齐、缺少 __init__.py（Python 3.3+ 可省略，但子包仍需）、或 zip 没加进 sys.path。
- 必须用
zipfile或系统命令确保 zip 是标准 ZIP 格式（无加密、无压缩方式非DEFLATED） - Python 启动前就得把 zip 路径插入
sys.path[0]，否则 import 查找不到 -
__main__.py不会被自动识别为入口——zip 本身不是可执行模块，不支持-m直接运行
如何构造一个可被 zipimport 加载的 zip 包？
关键不是“打包得漂亮”，而是路径结构和字节码兼容性。Python 会从 zip 中读取 .pyc 或按需编译 .py，但首次加载慢；若提前编译好 .pyc 并放入正确路径（如 __pycache__/main.cpython-311.pyc），能略提速，不过通常没必要。
使用场景：内嵌小工具、IoT 设备上节省 flash 空间、临时分发免安装脚本。
立即学习“Python免费学习笔记（深入）”；
- 确保源码文件在 zip 根目录（如
app.py），或按包结构组织（如mytool/__init__.py） - 不要用绝对路径打包：
zip -r tool.zip mytool/，而不是zip -r tool.zip /home/user/mytool/ - 避免符号链接、空目录、非 UTF-8 文件名——
zipimport不处理这些 - 测试是否合法：
python -c "import zipimport; zipimport.ZipImportError if not zipimport.zipimporter('tool.zip').find_module('app') else print('OK')"
为什么 import 成功了，但函数调用报 NameError？
这是最常踩的坑：zipimport 只解决模块加载，不自动执行模块顶层代码。如果 main.py 里写了 if __name__ == '__main__': run()，它不会触发——因为 __name__ 是 'main'，不是 '__main__'。
性能影响很小，但逻辑容易误判。真正执行得靠显式调用。
- 正确做法：
import main; main.run()或from main import run; run() - 如果想模拟
__main__行为，得手动设置：import sys; sys.modules['__main__'] = main（极少需要） - 注意相对导入失效：zip 包里
from .utils import helper会失败，除非整个包完整打包且用import mypackage方式加载
在 Docker 或受限环境里用 zipimport 有什么兼容性风险？
Python 版本必须严格匹配编译 .pyc 的版本（如果用了预编译），但纯 .py zip 在同大版本下基本安全（如 3.9–3.12 之间通常没问题）。更大的风险来自运行时权限和路径。
容易被忽略的地方：Docker 默认工作目录可能不在 zip 所在路径，sys.path 插入必须用绝对路径，且容器内得有读权限。
- 启动命令要带路径修正：
python -c "import sys; sys.path.insert(0, '/app/tool.zip'); import app; app.start()" - Alpine Linux 的 musl libc 下，某些 zip 工具生成的 archive 可能被拒载（报
Bad magic number），换用busybox unzip打包更稳 - Windows 上注意路径分隔符——zip 内部一律用
/，即使源文件是\
