Python读取文件报错FileNotFoundError怎么处理?

凌晨两点半
凌晨两点半
发布时间:2026-11-21| 13人浏览过
原创

深入解析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 脚本自身的存放位置为基准去查找文件,而是以终端当前所处的工作目录为基准进行寻址。

Python读取文件报错FileNotFoundError怎么处理?
图 1:相对路径寻址受当前工作目录影响示意

二、四步系统排查法

当终端中弹出 FileNotFoundError 时,可遵循以下四个步骤逐项排查:

Python读取文件报错FileNotFoundError怎么处理?
图 2:排查与定位 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__ 进行动态绝对路径计算。

Python读取文件报错FileNotFoundError怎么处理?
图 3:两类路径构造方式的工程可靠性对比

完整示例代码:稳定读取文件

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 结构。

Python读取文件报错FileNotFoundError怎么处理?
图 4:生产级稳健文件访问逻辑控制图

标准异常捕获范式:

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 构建具有韧性的代码。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。