在Python编程中，判断文件是否存在是一个常见的需求，无论是读取本地配置文件、处理用户上传的文件还是执行文件相关的批量操作，提前确认文件状态都能有效减少程序运行时的异常。下面介绍几种主流的实现方式。
使用os.path模块判断
os.path是Python标准库中处理路径的常用模块，其中提供了多个方法用于判断文件或目录的状态，最常用的是os.path.exists()方法，它可以判断指定路径是否存在，不管是文件还是目录都会返回True。
如果需要明确判断是否为文件而非目录，可以使用os.path.isfile()方法，该方法仅当路径存在且为普通文件时返回True。
示例代码
import os
# 要判断的文件路径
file_path = "./test.txt"
# 判断路径是否存在
if os.path.exists(file_path):
print(f"路径 {file_path} 存在")
else:
print(f"路径 {file_path} 不存在")
# 明确判断是否为文件
if os.path.isfile(file_path):
print(f"{file_path} 是一个存在的文件")
else:
print(f"{file_path} 不是文件或不存在")
使用pathlib模块判断
Python 3.4及以上版本引入了pathlib模块，它采用面向对象的方式处理文件路径，代码可读性更强，也是官方推荐的路径处理方式。
使用Path对象的exists()方法可以判断路径是否存在，is_file()方法可以判断是否为文件，用法和os.path模块的方法类似，但语法更加简洁。
示例代码
from pathlib import Path
# 创建Path对象
file_path = Path("./test.txt")
# 判断路径是否存在
if file_path.exists():
print(f"路径 {file_path} 存在")
# 判断是否为文件
if file_path.is_file():
print(f"{file_path} 是一个存在的文件")
使用异常捕获判断
除了主动判断路径状态，还可以通过捕获文件操作的异常来间接判断文件是否存在。这种方式的核心逻辑是尝试打开文件，如果抛出FileNotFoundError异常则说明文件不存在。
这种方式的优势是可以在判断的同时完成文件打开操作，减少重复的路径检查逻辑，适合紧接着就要读写文件的场景。
示例代码
file_path = "./test.txt"
try:
# 尝试以只读模式打开文件
with open(file_path, "r", encoding="utf-8") as f:
print(f"文件 {file_path} 存在，内容为：{f.read()}")
except FileNotFoundError:
print(f"文件 {file_path} 不存在")
except Exception as e:
print(f"打开文件时出现其他错误：{e}")
不同方法的对比与选择
三种方法各有适用场景，我们可以通过下面的表格快速对比：
| 方法 | 适用场景 | 优势 | 劣势 |
|---|---|---|---|
| os.path模块 | 兼容Python 2和Python 3的老项目 | 兼容性好，用法简单 | 函数式编程风格，可读性弱于pathlib |
| pathlib模块 | Python 3.4以上的新项目 | 面向对象，可读性强，功能丰富 | 不支持Python 3.4以下版本 |
| 异常捕获 | 判断后紧接着要操作文件的场景 | 逻辑连贯，减少重复检查 | 仅适合文件操作场景，不适合单纯的判断需求 |
注意事项
- 判断文件存在后，如果其他进程删除了该文件，后续操作仍可能报错，因此关键操作建议结合异常捕获使用。
- 路径可以使用相对路径或绝对路径，相对路径默认相对于当前工作目录，需要注意工作目录的设置。
- 如果需要判断的是符号链接指向的文件，
is_file()默认会跟随符号链接判断，若需要判断符号链接本身可以额外添加参数。