Python importlib.resources.files 怎么访问压缩包内资源

把 Python 包压成 zip 后，资源文件不一定对应一个可以直接交给 open() 的本地路径。更稳妥的做法是先用 importlib.resources.files() 获取一个 Traversable，再按“只读内容”或“必须要路径”选择 API：文本、二进制内容直接读取；第三方库要求 pathlib.Path 时，使用 as_file() 的上下文管理器。

files() 先返回资源容器，不要急着拼本地路径

files(anchor) 的返回值可以理解为“包里的资源容器”，但它不是承诺永远存在的本地目录。anchor 可以是包名或模块对象；下面用包名表达一个位于 demo_pkg/data/config.json 的资源：

from importlib.resources import files

# 资源路径相对于包锚点，使用正斜杠语义，不依赖当前工作目录
config_resource = files("demo_pkg").joinpath("data", "config.json")

# Traversable 适合继续定位、判断和读取资源
if config_resource.is_file():
    text = config_resource.read_text(encoding="utf-8")
    print(text)

这里的 config_resource 是 Traversable，因此可以继续 joinpath()、is_file()、read_text() 或 read_bytes()。当包由 zipimport 提供时，这些操作由资源加载器处理，不需要先把整个包解压到当前目录。

只读内容时直接读取，路径需求才使用 as_file()

如果下游逻辑只需要字符串或字节，直接读取最简单。需要交给只接受真实路径的库（例如要求文件名、调用 stat() 或打开外部工具）时，再建立文件系统桥接：

from importlib.resources import as_file, files

# 先定位包内资源，再按需获得临时或真实的 pathlib.Path
resource = files("demo_pkg").joinpath("data", "schema.json")

with as_file(resource) as path:
    # 只在 with 内使用 path；压缩包资源可能在这里被临时释放
    size = path.stat().st_size
    print(f"schema bytes: {size}")

# 离开 with 后不要缓存 path；临时资源可能已经被清理

as_file() 返回上下文管理器。普通目录资源通常可以直接映射到现有路径，压缩包资源则可能需要临时解压；离开 with 后，临时文件或目录会被清理。因此不要把 path 写入全局变量，也不要在上下文外异步使用它。

Python 3.12 起，as_file() 也支持代表目录的 Traversable。如果库需要遍历一个模板目录，可以把目录传入 as_file()，并让所有读取、拷贝或扫描动作都发生在同一个上下文内。

压缩包资源访问的参数与边界

files() 在 Python 3.9 引入；Python 3.12 将参数名从 package 调整为 anchor，新代码直接按位置传入包名最省兼容心智。不要把 resource 强行转换成 Path(resource)：它可能只是抽象资源对象，而不是操作系统路径。

常见问题

为什么 zip 包里的资源不能一直保存成 Path？

因为压缩包内条目不天然是文件系统路径；as_file() 产生的路径还可能是临时文件。把依赖路径的动作放进 with，用完再释放。

什么时候不需要 as_file()？

只要目标 API 接受字符串内容、字节或文件对象，就优先使用 read_text()、read_bytes() 或 open()，这样不引入临时解压和生命周期问题。

files() 找不到资源时先查什么？

先确认资源确实位于包内、相对路径大小写正确，并检查打包配置是否把 data 文件纳入发布物；不要先改成当前工作目录拼接。