Python pathlib.Path.info 怎么减少重复 stat：缓存语义、目录遍历与失效边界

目录扫描里最容易被忽略的一笔开销，是对每个路径反复做文件类型查询。Python 3.14 给 pathlib.Path 增加了 info 属性：从 Path.iterdir() 得到的路径可以直接利用父目录扫描时拿到的类型信息，适合先做一轮文件/目录分类。不过 Path.info 不是实时监控器，文件后来发生变化时，仍要用路径方法或创建新的 Path 对象确认状态。

批量遍历时可以用 entry.info.is_dir() 做快速分类；需要最新结果时改用 entry.is_dir()、entry.is_file() 或重新构造 Path(entry)，不要把缓存判断当成当前事实。

Path.info 解决的是哪一类重复查询

传统写法通常是先拿到路径，再调用 is_dir()、is_file() 或 is_symlink()。如果目录很大，程序会对很多条目逐一询问文件系统。Python 3.14 的 Path.info 给这些类型判断加了一层按路径对象保存的结果，目标是减少“先遍历、再重复判断”的成本。

它提供的不是一个新的文件类型，而是一个实现了 PathInfo 协议的对象。常用方法包括 exists()、is_dir()、is_file() 和 is_symlink()。直接访问 path.info 本身不会主动发起文件系统查询。

支持范围：为什么 iterdir() 场景最值得用

Path.info 在 Python 3.14 加入。对普通的 Path("data/report.csv")，首次使用信息方法时，程序仍可能需要读取文件系统；而 Path.iterdir() 返回的条目会利用扫描父目录时收集到的类型信息，这正是它最有价值的路径。

最小写法：先用 info 做目录分类

下面的例子只负责把目录条目分成子目录、普通文件和其他类型。它没有把 Path.info 当作路径属性直接比较，而是调用协议提供的判断方法。

from pathlib import Path

root = Path("incoming")
for entry in root.iterdir():
    if entry.info.is_dir():
        print("目录", entry.name)
    elif entry.info.is_file():
        print("文件", entry.name)
    else:
        print("其他", entry.name)

这里的检查结果适合做第一轮分流，例如只把文件交给解析器、把目录交给递归扫描。若后续要打开文件，仍然应该处理文件在扫描后被删除、替换或改成符号链接的情况，不能因为第一轮判断成功就跳过异常处理。

缓存什么时候会过期：先看清楚“快”与“新”

假设程序扫描到 incoming/report.csv 后，另一个进程把它替换成了目录。原来的 Path 对象里已经保存了之前得到的类型信息，继续调用 entry.info.is_file() 不等于重新读取当前目录项。

要拿最新状态，应调用路径自身的 is_dir()、is_file() 或 is_symlink()。这组方法和 Path.info 的缓存语义不同，适合在即将打开、移动或删除前做一次复查。

entry = Path("incoming/report.csv")

if entry.is_file():
    with entry.open("rb") as stream:
        header = stream.read(16)
else:
    raise FileNotFoundError(entry)

没有清空缓存的接口，怎么得到新的 PathInfo

Python 3.14 文档明确说明，不能直接重置一个路径对象的 info 缓存。需要重新获得空的信息缓存时，可以基于原对象创建新的路径对象：

fresh_entry = Path(entry)
if fresh_entry.info.is_file():
    print("按新对象重新判断")

不过要注意，重新构造对象只解决“不要沿用旧对象缓存”这件事；它不是事务锁，也不能保证下一行代码执行时文件还没有被其他进程修改。对敏感操作，最终仍要让打开、读取和异常处理承担事实核对。

兼容 Python 3.13 及更早版本

如果项目还支持 Python 3.13 或更早版本，不要无条件访问 info。可以把“快速分类”和“兼容回退”封装在一个小函数里，让主流程不关心运行时版本：

from pathlib import Path

def is_directory(path: Path) -> bool:
    info = getattr(path, "info", None)
    if info is not None:
        return info.is_dir()
    return path.is_dir()

for entry in Path("incoming").iterdir():
    if is_directory(entry):
        print(entry)

如果应用已经统一要求 Python 3.14，也可以直接依赖 Path.info，但部署检查要和本地解释器一致。仅在代码里写了新属性、没有同步运行时版本，通常会把问题推迟到第一次目录扫描才暴露。

几个容易误用的边界

• 不要把 info 当实时状态。目录扫描结束后可能有其他进程改变条目，关键动作前重新确认。
• 不要为了“刷新”修改同一个 Path。文档没有提供清空缓存的方法，直接复用旧对象不会得到新结果。
• 不要把减少查询当成性能保证。网络文件系统、权限、目录规模和后续打开方式都会影响实际收益，应该用应用自己的扫描耗时和系统调用数据验证。
• 不要忽略符号链接。is_symlink()、is_file() 和 is_dir() 对链接跟随方式不同，按业务需要选择，并继续处理异常。

相关问题

Path.info 是不是 Path.stat() 的替代品？

不是。它主要服务于文件类型判断和缓存复用；需要完整元数据时，仍应使用 stat()，不要从 PathInfo 推断大小、时间或权限。

为什么 iterdir() 得到的 Path 更适合使用 info？

因为目录遍历阶段已经收集过子项的部分类型信息，返回的路径对象可以带着这部分结果继续判断，减少重复查询的机会。

文件刚被替换，重新调用 entry.info.is_file() 可以吗？

不适合把它当最新结论。改用 entry.is_file()，或用 Path(entry) 生成新对象后再判断；真正打开文件时还要处理竞态异常。

落地时保留两条判断线

批量扫描、只做类型分流时，Path.info 是 Python 3.14 中很顺手的优化点；需要新鲜状态时，使用路径方法或新对象。把“快速分类”和“最终操作”分成两条判断线，既能利用缓存，也不会把旧信息误当成文件系统当前状态。