# `zipimport` --- 从 Zip 归档导入模块

源代码： Lib/zipimport.py

此模块增加了从 ZIP 格式归档中导入 Python 模块 (`*.py`、`*.pyc`) 和包的能力。 通常不需要显式地使用 `zipimport` 模块；对于 `sys.path` 中指向 ZIP 归档的路径条目，内置的 `import` 机制会自动使用它。

通常， `sys.path` 是字符串的目录名称列表。此模块同样允许 `sys.path` 的一项成为命名 ZIP 文件档案的字符串。 ZIP 档案可以容纳子目录结构去支持包的导入，并且可以将归档文件中的路径指定为仅从子目录导入。比如说，路径 `example.zip/lib/` 将只会从档案中的 `lib/` 子目录导入。

任何文件都可以放到 ZIP 档案中，但只有 `.py` 和 `.pyc` 文件会触发导入器操作。 动态模块 (`.pyd`, `.so`) 的 ZIP 导入是不被允许的。 请注意如果一个档案只包含有 `.py` 文件，那么 Python 将不会尝试通过添加对应的 `.pyc` 文件来修改档案，这意味着如果一个 ZIP 档案不包含 `.pyc` 文件，则导入速度可能会相当慢。

在 3.15 版本发生变更: Zstandard (zstd) compressed zip file entries are supported.

在 3.13 版本发生变更: 已支持 ZIP64

在 3.8 版本发生变更: 以前，不支持带有档案注释的 ZIP 档案。

参见

PKZIP Application Note

  由 ZIP 文件格式及所使用算法的创建者 Phil Katz 编写的文档。

PEP 273 - 从 ZIP 压缩包导入模块

  由 James C. Ahlstrom 编写，他也提供了实现。 Python 2.3 遵循 PEP 273 的规范，但是使用 Just van Rossum 编写的使用了 PEP 302 中描述的导入钩子的实现。

`importlib` - 导入机制的实现

  为所有导入器的实现提供相关协议的包。

此模块定义了一个异常：

exception zipimport.ZipImportError

  异常由 zipimporter 对象引发。这是 `ImportError` 的子类，因此，也可以捕获为 `ImportError` 。

## zipimporter 对象

`zipimporter` 是用于导入 ZIP 文件的类。

class zipimport.zipimporter(archivepath)

  创建新的 zipimporter 实例。 archivepath 必须是指向 ZIP 文件的路径，或者 ZIP 文件中的特定路径。例如， `foo/bar.zip/lib` 的 archivepath 将在 ZIP 文件 `foo/bar.zip` 中的 `lib` 目录中查找模块（只要它存在）。

  如果 archivepath 没有指向一个有效的 ZIP 档案，引发 `ZipImportError` 。

  在 3.12 版本发生变更: 在 3.10 中已弃用的 `find_loader()` 和 `find_module()` 方法现在已被移除。 请改用 `find_spec()`。

  create_module(spec)

    返回 `None` 来显式地请求默认语义的 `importlib.abc.Loader.create_module()` 实现。

    Added in version 3.10.

  exec_module(module)

    `importlib.abc.Loader.exec_module()` 的实现。

    Added in version 3.10.

  find_spec(fullname, target=None)

    `importlib.abc.PathEntryFinder.find_spec()` 的实现。

    Added in version 3.10.

  get_code(fullname)

    返回指定模块的代码对象。 如果模块无法被导入则引发 `ZipImportError`。

  get_data(pathname)

    返回与 pathname 相关联的数据。如果不能找到文件则引发 `OSError`。

    在 3.3 版本发生变更: 过去触发的 `IOError`，现在是 `OSError` 的别名。

  get_filename(fullname)

    返回如果指定模块被导入则应当要设置的 `__file__` 值。 如果模块无法被导入则引发 `ZipImportError`。

    Added in version 3.1.

  get_source(fullname)

    返回指定模块的源代码。如果没有找到模块则引发 `ZipImportError` ，如果档案包含模块但是没有源代码，返回 `None` 。

  is_package(fullname)

    如果由 fullname 指定的模块是一个包则返回 `True`。如果不能找到模块则引发 `ZipImportError`。

  invalidate_caches()

    清除在 ZIP 归档文件中找到的相关文件信息的内部缓存。

    Added in version 3.10.

  archive

    导入器关联的 ZIP 文件的文件名，没有可能的子路径。

  prefix

    ZIP 文件中搜索模块的子路径。对于指向 ZIP 文件根目录的 zipimporter 对象，该值为空字符串。

  当与斜杠结合使用时， `archive` 和 `prefix` 属性等价于赋予 `zipimporter` 构造器的原始 archivepath 参数。

## 例子

这是一个从 ZIP 归档导入模块的示例——请注意并未显式地使用 `zipimport` 模块。

    $ unzip -l example_archive.zip
    Archive:  example_archive.zip
      Length     Date   Time    Name
     --------    ----   ----    ----
         8467  01-01-00 12:30   example.py
     --------                   -------
         8467                   1 file

    >>> import sys
    >>> # 将归档添加到模块搜索路径的最前面
    >>> sys.path.insert(0, 'example_archive.zip')
    >>> import example
    >>> example.__file__
    'example_archive.zip/example.py'