Python读取文件报错FileNotFoundError怎么处理?
深入解析Python读取文件时出现FileNotFoundError的原因与排查步骤,提供基于当前工作目录排查、Pathlib路径锚定、文件名检查及异常安全捕获的完整实用方案。
在 Python 文件处理过程中,FileNotFoundError: [Errno 2] No such file or directory 是最常见的异常之一。该错误的直接原因非常明确:Python 解释器在尝试定位指定路径下的文件时,没有在文件系统中找到对应的条目。解决该问题的核心在于理清“当前工作目录”与“目标文件真实物理路径”之间的映射关系,并通过规范化的路径锚定技术从根本上消除寻址偏差。
一、为什么会出现 FileNotFoundError?
很多初学者会疑惑:“文件明明和 Python 脚本放在同一个文件夹下,为什么执行 open('data.txt') 依然报错?”
出现这种现象的关键在于混淆了两个概念:脚本所在的物理目录(Script Directory)与执行命令时的当前工作目录(Current Working Directory, CWD)。当我们在代码中使用相对路径时,Python 并非以 .py 脚本自身的存放位置为基准去查找文件,而是以终端当前所处的工作目录为基准进行寻址。
二、四步系统排查法
当终端中弹出 FileNotFoundError 时,可遵循以下四个步骤逐项排查:
1. 打印并验证当前工作目录
在引发异常的代码行前添加如下诊断代码,观察控制台实际输出:
import os
print("当前 Python 解释器的工作目录为:", os.getcwd())
输出结果代表了当前相对路径的计算起点。如果输出是 /Users/name/projects,而你的文件在 /Users/name/projects/demo/data.txt,那么单纯写 open('data.txt') 就会寻找 /Users/name/projects/data.txt 并报错。
2. 检查真实扩展名与隐藏后缀
在 Windows 操作系统中,系统默认会“隐藏已知文件类型的扩展名”。如果新建了一个文本文档并手动命名为 data.txt,其实际完整文件名可能变成了 data.txt.txt。可以在命令行或终端中使用 dir(Windows)或 ls -la(macOS/Linux)查看确切的文件名。
此外,Linux 和 macOS 系统对文件名大小写敏感(例如 Data.csv 与 data.csv 是两个完全不同的文件),需严格确认大小写一致。
3. 处理 Windows 路径中的转义字符
在 Windows 环境下使用硬编码反斜杠时,容易踩中字符串转义陷阱。例如:
# 错误示例:\t 和 \n 被当作制表符与换行符解析
path = "C:\project\test\new_file.txt"
# 推荐写法一:在字符串前加 r 声明为原始字符串(Raw String)
path = r"C:\project\test\new_file.txt"
# 推荐写法二:全平台通用的正斜杠
path = "C:/project/test/new_file.txt"
三、推荐解决方案:基于 Pathlib 锚定脚本路径
为了让脚本无论在哪个目录下被执行(无论是 VS Code、PyCharm、终端根目录还是定时任务中),都能准确无误地定位自身附带的数据文件,最工程化的做法是利用内置库 pathlib 并结合 __file__ 进行动态绝对路径计算。
完整示例代码:稳定读取文件
from pathlib import Path
# 获取当前正在运行的 Python 文件所在目录的绝对路径
BASE_DIR = Path(__file__).resolve().parent
# 基于当前脚本位置拼接目标数据文件路径
target_file = BASE_DIR / "data" / "sample.txt"
# 检查文件物理存在性
if not target_file.exists():
print(f"提示:目标文件不存在,请检查路径: {target_file}")
else:
with open(target_file, "r", encoding="utf-8") as f:
content = f.read()
print("文件读取成功,内容前50字符为:", content[:50])
四、工程防御设计:异常捕获与容错机制
在实际生产环境中,除了避免路径错误外,外部数据文件可能因为权限被移走、尚未生成或网络挂载延迟等原因暂时不可用。因此,编写稳健的文件操作应当包含 try...except FileNotFoundError 结构。
标准异常捕获范式:
from pathlib import Path
import logging
def load_user_data(file_path: str) -> str:
target = Path(file_path).resolve()
try:
with open(target, "r", encoding="utf-8") as f:
return f.read()
except FileNotFoundError:
logging.error("未找到目标文件,解析后的物理路径为: %s", target)
# 返回默认内容或根据业务需要重新抛出附带上下文信息的异常
return "{}"
# 测试调用
content = load_user_data("settings.json")
排查总结:处理 FileNotFoundError 并非只是简单地修改文件名,而应当建立清晰的路径意识:确认当前 CWD ➔ 检查真实扩展名与转义符 ➔ 使用 pathlib.Path(__file__).resolve().parent 消除工作目录漂移 ➔ 配合 try...except 构建具有韧性的代码。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









