与路径存在性检查相关的函数主要有 os.path.exists() 和 pathlib.Path.exists()。

在 Python 中，路径字符串调用 exists()（无论是 os.path.exists() 还是 pathlib.Path.exists()）的核心原理是：通过调用操作系统的底层接口（系统调用）来尝试获取该路径的状态信息，并根据调用结果返回 True 或 False

核心机制：基于 os.stat()

两种方法都建立在 os.stat() 这个核心函数之上。

• os.path.exists(path): 它的实现非常直接，就是在一个 try...except 块中调用 os.stat(path)。

  • 如果 os.stat() 调用成功，说明路径存在，函数返回 True。

  • 如果 os.stat() 调用失败并抛出异常（如 OSError, ValueError），函数则捕获异常并返回 False。

• pathlib.Path.exists(): 作为面向对象的路径模块，它的底层实现与 os.path.exists() 类似，也是调用 os.path.exists() 或直接进行 stat() 系统调用。它同样会抑制所有 OSError 异常，最终只返回 True 或 False。

深入底层：操作系统系统调用

os.stat() 函数本身是一个对操作系统底层API的封装。

• 在 Unix/Linux 系统上：os.stat() 最终会调用 C 语言的 stat() 函数，该函数再通过 stat 系统调用向内核询问文件信息。

• 在 Windows 系统上：os.stat() 则直接调用 Windows 的底层 API（如 GetFileAttributesExW）来获取文件属性。

操作系统是唯一知道文件或目录是否存在的“权威”，因此这种“询问操作系统”的方式是判断路径是否存在的根本途径。

关键行为与注意事项

1. 符号链接（软链接）：

   • exists() 默认会跟随符号链接，检查的是链接所指向的目标文件或目录是否存在。

   • 如果符号链接指向的目标不存在（即“损坏的符号链接”），exists() 会返回 False。

   • pathlib.Path.exists() 可以通过 follow_symlinks=False 参数来改变此行为，使其检查符号链接本身是否存在。

2. 权限问题：

   • 即使路径存在，如果程序对该路径的父目录没有“执行（搜索）”权限，os.stat() 调用也会失败并抛出 PermissionError 异常。

   • 此时，exists() 会捕获该异常并返回 False。这意味着 exists() 返回 False 并不绝对代表路径不存在，也可能是由于权限不足无法访问。

3. 路径字符串中的特殊字符：

   • 如果路径字符串包含操作系统层面无法表示的字符，os.stat() 会抛出异常。自 Python 3.8 起，exists() 会返回 False 而不是抛出异常。

   • 对于路径字符串中包含的空字符 \0，exists() 可能会抛出 ValueError 异常。

总结

路径字符串 + exists() 的本质是 Python 对操作系统底层 stat 系统调用的一个安全封装。它通过“试错”的方式，将获取文件状态的成功与否，直接转化为布尔值 True 或 False 返回给开发者。

常见用法：

1、读取文件前的安全预判（LBYL 风格）

import os
from pathlib import Path

# 传统写法
if os.path.exists("config.ini"):
    with open("config.ini", "r") as f:
        data = f.read()

# 现代写法
if Path("config.ini").exists():
    with open("config.ini", "r") as f:
        data = f.read()

2、创建目录前防止报错

p = Path("/tmp/my_project/data")
if not p.exists():
    p.mkdir(parents=True)  # 父目录不存在时一并创建

3、清理或备份文件前判断

backup = Path("data.bak")
if backup.exists():
    backup.unlink()  # 存在则删除旧备份

注意事项：

1、致命的“竞态条件”（TOCTOU 问题）

这是 exists() 最大的陷阱。检查通过 和 后续操作 之间有时间差，文件可能在这瞬间被删除、修改或创建。

正确做法（推荐 EAFP 风格）：直接尝试操作，用 try...except 捕获异常。

try:
    with open("report.txt") as f:
        ...
except FileNotFoundError:
    print("文件不存在，跳过处理")

2、权限不足返回 False（误导性）

如果路径存在，但你的程序对父目录没有“执行（搜索）”权限，os.stat() 会抛出 PermissionError，而被 exists() 捕获并返回 False。

    结论：exists() 返回 False 不代表路径绝对不存在，也可能是无权访问。

3、不区分文件和目录

exists() 只问“有没有”，不问“是什么”。

    如果你需要确保它是一个普通文件，请用 .is_file()。

    如果你需要确保它是一个目录，请用 .is_dir()。

p = Path("/dev/null")
print(p.exists())  # True
print(p.is_file()) # True（在某些系统上）

p = Path("/etc")
print(p.exists())  # True
print(p.is_file()) # False（它是目录）

4、符号链接的特殊行为

os.path.exists()：永远跟随链接，检查目标。如果链接损坏（目标丢失），返回 False。

pathlib.Path.exists()：默认跟随。若想检查链接本身是否存在（即使目标坏了），在 Python 3.12+ 中可传参：

p = Path("broken_symlink")
print(p.exists())                     # False（目标不存在）
print(p.exists(follow_symlinks=False)) # True（链接文件本身还在）

5、性能开销（系统调用）

exists() 涉及内核级别的系统调用（如 Linux 的 stat），比纯 Python 内存操作慢得多（约微秒级）。

• 避免：在毫秒级循环（如 for 循环百万次）中频繁调用 exists()。如果确需检查，考虑在循环外缓存结果，或重构逻辑。

6、路径中的非法字符

• 包含操作系统不支持的字符时，exists() 通常返回 False（Python 3.8+）。

• 包含空字符 \0 时，会直接抛出 ValueError 异常，因为它不是合法的路径字符串。

总结：最佳实践建议

1. 优先使用 pathlib.Path：代码更现代、易读，且面向对象风格便于扩展。

2. 不要用 exists() 做安全闸门：在涉及文件读写、删除、移动等并发场景下，放弃 LBYL，坚决使用 try...except 处理 FileNotFoundError 或 PermissionError。

3. 区分需求：若只是给用户展示提示信息（如 UI 显示“文件存在”），用 exists()；若逻辑强制依赖文件属性，用 .is_file() 或 .is_dir()。

4. 不要依赖它做安全防护：攻击者可以利用时间差绕过检查（竞态条件），安全场景必须用原子性操作或异常捕获。