exists路径判断 - pathlib存在性检查与is_file方法

一、概述

Path.exists() 方法用于判断路径在文件系统中是否存在。它可以检查文件和目录是否存在，是文件系统操作中最基本的判断方法之一。

在进行文件读写、目录创建等操作前，通常需要先使用 exists() 判断路径是否存在，以避免异常。

二、语法与参数

Path.exists()

参数说明

返回值

返回 bool 值：路径存在返回 True，不存在返回 False。对于损坏的符号链接，返回 False。

三、代码示例

示例1：基本判断

from pathlib import Path

# 判断当前目录是否存在
cwd = Path.cwd()
print(f"当前目录存在: {cwd.exists()}")

# 判断不存在的路径
fake = Path('/nonexistent/path/file.txt')
print(f"不存在路径: {fake.exists()}")

# 输出：
# 当前目录存在: True
# 不存在路径: False

示例2：文件操作前的安全检查

from pathlib import Path

config_path = Path('config.ini')

if config_path.exists():
    print("配置文件已存在，读取内容...")
    # content = config_path.read_text()
else:
    print("配置文件不存在，创建默认配置...")
    # config_path.write_text('[default]\nkey=value')

# 检查多个路径
paths_to_check = [
    Path.cwd() / 'README.md',
    Path.cwd() / 'setup.py',
    Path.cwd() / 'pyproject.toml',
]

print("\n项目文件检查:")
for p in paths_to_check:
    status = "存在" if p.exists() else "不存在"
    print(f"  {p.name}: {status}")

# 输出：
# 配置文件不存在，创建默认配置...
#
# 项目文件检查:
#   README.md: 存在
#   setup.py: 不存在
#   pyproject.toml: 不存在

示例3：目录存在性检查与创建

from pathlib import Path

# 安全创建目录
output_dir = Path.cwd() / 'output' / 'results'

if not output_dir.exists():
    output_dir.mkdir(parents=True, exist_ok=True)
    print(f"目录已创建: {output_dir}")
else:
    print(f"目录已存在: {output_dir}")

# 输出：
# 目录已创建: e:\WorkTools\AutoCode\workspace3\output\results

四、实际应用场景

• 文件读写安全检查：在读取文件前检查是否存在，避免 FileNotFoundError

• 配置文件检测：检查配置文件是否存在，不存在则使用默认值

• 目录初始化：检查输出目录是否存在，不存在则创建

五、注意事项

注意1：exists() 对损坏的符号链接返回 False，即使链接目标路径存在。

注意2：在多线程/多进程环境中，exists() 的结果可能在使用前就已过期（TOCTOU 问题）。建议使用 try-except 处理文件操作异常。

注意3：exists() 不能区分文件和目录。如需区分，请使用 is_file() 或 is_dir()。

提示：对于"检查后操作"的模式，更推荐直接操作并用 try-except 捕获异常，而非先 exists() 再操作。

六、exists与其他判断方法对比

七、小结

• exists() 判断路径是否存在，不区分文件和目录

• 是文件系统操作前的基本安全检查方法

• 注意 TOCTOU 问题，建议配合 try-except 使用

• 如需区分文件和目录，使用 is_file() 或 is_dir()

八、练习题

九、小贴士