Python pathlib.Path.info 有什么用：文件类型缓存、stat 刷新与批量扫描性能

目录扫描工具经常先判断“这是文件还是目录”，再决定要不要读取内容。Python 3.14 的 pathlib.Path.info 给这一步增加了一层类型信息缓存：从 Path.iterdir() 得到的路径可以直接用缓存结果分流，减少重复系统调用，但它不是永远最新的文件状态。

先做一个可验收的目录扫描器

先把目标压缩成一个小项目：扫描 incoming/，把普通文件交给处理函数，把目录和符号链接分别记日志，最后输出数量。这个场景适合观察 Path.info 的价值，因为同一批路径会连续做多次类型分流。

from pathlib import Path

root = Path("incoming")
files = []
directories = []
links = []

for path in root.iterdir():
    if path.info.is_symlink():
        links.append(path)
    elif path.info.is_dir():
        directories.append(path)
    elif path.info.is_file():
        files.append(path)

print({"files": len(files), "directories": len(directories), "links": len(links)})

这里的关键不是把代码写得更短，而是让“枚举”和“分流”处在同一轮扫描里。官方文档明确说明，Path.iterdir() 产生的路径可能带有从父目录扫描中得到的类型信息，访问 path.info 本身不会再次查询文件系统。

Path.info 到底缓存了什么

Path.info 返回的是支持文件类型查询的对象，常用方法包括 exists()、is_file()、is_dir() 和 is_symlink()。它主要服务于“先按类型选择分支”的场景，不等价于一次完整的 stat() 快照。

尤其要注意来源不同会影响初始信息：从 iterdir() 得到的路径通常比手工写出的 Path("incoming/a.txt") 更可能携带目录扫描时已知的类型信息。把路径对象打印出来并不会刷新这个状态。

文件在扫描期间变化时，别把缓存当事实

假设扫描器枚举目录后，另一个进程把 report.csv 删除并创建成同名目录。原来的 Path 对象不会自动知道这个变化。此时再读取 path.info.is_file()，结果可能仍然反映之前获得的类型信息。

需要以当前文件系统状态做决定时，直接使用具体路径的方法：

from pathlib import Path

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

if path.is_file():
    size = path.stat().st_size
    print("read file", size)
elif path.is_dir():
    print("skip directory")
else:
    print("missing or inaccessible")

这也是一个很实用的边界：缓存适合优化稳定的批处理判断，实时变化的文件夹、清理任务和安全检查则应该重新查询，并且对查询和后续打开之间的竞态保持警惕。

没有缓存重置方法时怎么重新开始

官方文档没有提供清空 Path.info 的方法。如果确实要得到一个空的缓存，可以从旧路径重新构造一个路径对象：

from pathlib import Path

old_path = Path("incoming/report.csv")
fresh_path = Path(old_path)

if fresh_path.is_file():
    print(fresh_path.stat().st_size)

不过，创建新对象不是并发一致性方案。它只是让后续的路径查询不沿用旧对象的类型缓存；在“判断之后马上打开”的代码里，仍要处理文件消失、权限改变和符号链接变化等异常。

把小项目跑通并验收

用下面的文件夹准备三个对象，再运行扫描脚本：

mkdir -p incoming/archive
printf 'ok\n' > incoming/report.csv
ln -s report.csv incoming/latest.csv
python scan_incoming.py

验收时重点看三件事：普通文件是否进入 files，archive 是否进入 directories，符号链接是否被优先识别为 links。如果业务要求追踪链接目标而不是链接本身，就要明确传递相应的跟随语义，不能只凭列表数量判断结果正确。

常见问题

Path.info 是不是 Python 3.14 之前就有？

不是。它在 Python 3.14 加入。需要兼容旧版本时，应继续使用 is_file()、is_dir() 和 stat() 等已有接口。

Path.info 能不能代替 stat？

不能。它面向文件类型判断，不提供完整的大小、时间等元数据；这些信息仍应通过 stat() 获取。

为什么 Path(old_path) 能帮助刷新？

因为它会创建一个没有沿用旧 Path.info 缓存的新路径对象。刷新后仍需重新查询，并不能消除文件系统并发变化。

小结

Path.info 解决的是批量扫描中“类型判断很频繁”的问题。把它放在 iterdir() 产生的路径上，可以让分流代码更贴近 Python 3.14 的路径实现；一旦任务要求最新状态或完整元数据，就切回 is_file()、is_dir() 和 stat()。记住这个分界，性能优化才不会变成错误判断。