Python Path.info 缓存的文件类型信息什么时候会过期

先给结论：Path.info 没有按固定秒数自动过期的规则。它是一个可能缓存文件类型判断结果的对象；路径在目录扫描后得到的初始信息也可能来自扫描时刻。文件在此后被创建、删除、改名或替换时，继续读取 p.info 就可能不是当前状态。需要最新结果时，直接调用 p.is_dir()、p.is_file()、p.is_symlink()，或者用 Path(p) 生成一个新的路径对象。

官方地址：https://docs.python.org/3.14/library/pathlib.html

Path.info 到底缓存了什么

Python 3.14 给具体路径增加了 info 属性，它提供面向文件类型的查询，例如是否存在、是否为目录、是否为文件或符号链接。这样做适合在已经拿到一批目录项时快速分流，但它不是一个带 TTL 的缓存服务，也没有公开的“刷新”或“过期时间”参数。

与之相对，Path.is_dir() 等 Path 方法是需要当前判断时的优先选择。下面的代码把两类调用明确分开：

from pathlib import Path

path = Path("workspace/item")

# info 适合做低成本的类型分流，但不要把它当作实时快照。
if path.info.is_dir():
    print("可能是目录")

# Path 方法用于重新判断当前文件系统状态。
if path.is_dir():
    print("此刻确认是目录")

第一句可能使用已有缓存，第二句表达的是“现在再判断一次”。两者都返回布尔值，但语义不同。

为什么 iterdir() 产生的 Path 更容易遇到旧信息

如果路径对象来自 Path.iterdir()，Python 可以把扫描父目录时已经获得的类型信息放进该对象的 info 属性。这样遍历目录时不用为每个条目重复发起同一类系统调用，但目录遍历结束后，其他进程仍可能修改这些条目。

例如，生产者把临时文件改名为正式目录，消费者手里仍保存着旧的路径对象。此时不要用缓存结果决定是否递归：

from pathlib import Path

root = Path("inbox")
for entry in root.iterdir():
    # 这里的 info 可能沿用目录扫描时的类型线索。
    cached_kind = "dir" if entry.info.is_dir() else "other"

    # 递归前重新询问文件系统，避免把旧线索当成当前事实。
    if entry.is_dir():
        print(f"进入目录: {entry}")
    else:
        print(f"跳过 {cached_kind}: {entry}")

实时判断应该调用哪些方法

文章标题中的“过期”，更准确地说是“缓存与文件系统当前状态可能不一致”。没有统一刷新函数，按业务目标选方法即可：

Python 3.13 起部分方法支持 follow_symlinks=False。如果业务区分“链接本身”和“链接指向的目标”，要把这个参数写清楚，否则“目录判断不一致”可能并非缓存造成。

没有清空接口时如何重建一个干净对象

当路径对象已经在多个函数间传递，且你不确定它的 info 是否被初始化，可以通过 Path(p) 创建一个新的 Path 对象。官方文档给出的用途就是获得空的 info 缓存，而不是修改原对象：

from pathlib import Path

def current_path_info(path: Path) -> tuple[bool, bool]:
    # 重新构造对象，丢弃旧对象携带的 PathInfo 状态。
    fresh = Path(path)

    # 仍用 Path 方法作最终判断，避免把空缓存误解成实时事务。
    return fresh.is_file(), fresh.is_dir()

file_state, dir_state = current_path_info(Path("inbox/item"))
print(file_state, dir_state)

重建对象只解决 Path.info 的缓存携带问题，不会锁住目录，也不会让接下来的多个系统调用原子化。若文件在两次判断之间被替换，仍应依赖打开文件时的错误处理或更合适的系统级协调。

三个常见误区

1. 把它当成 TTL 缓存。 Path.info 没有“几秒后失效”的承诺，不能通过等待一段时间来获得刷新。
2. 用不存在的 refresh() 方法。 正确做法是调用 Path 的判断方法，或用 Path(p) 创建新对象。
3. 把类型判断当成业务事务。 判断为目录后，目录可能马上被删除；真正打开、遍历或写入时仍要处理 OSError。

结论与排查清单

需要速度、且文件系统变化受控时，可以使用 Path.info 做类型分流；需要当前状态时，优先调用 is_dir()、is_file() 或 is_symlink()。路径来自 iterdir()、跨进程共享，或经历了重命名和替换时，把它视为可能带旧线索的对象；用 Path(p) 重建并在实际 I/O 处捕获异常。

快速判断：没有固定过期时间；没有清空缓存 API；实时结果靠 Path 方法；重建对象靠 Path(p)。

相关问题

Path.info 是 Python 哪个版本新增的

它在 Python 3.14 加入。如果项目要兼容更早版本，应继续使用传统的 Path 判断方法。

Path.info.is_dir() 和 Path.is_dir() 一样吗

判断目标相同，但前者可能复用缓存，后者用于获取更接近当前文件系统的结果，不能混用语义。

重新执行 Path(p) 会强制刷新磁盘吗

不会。它只是创建不带原 info 缓存的新路径对象；是否访问文件系统取决于之后调用的具体方法。