Python FileNotFoundError 文件不存在错误详解

FileNotFoundError是Python中因文件或路径不存在而抛出的异常。需检查文件名、路径正确性及工作目录，使用os.path.exists()验证存在性，并通过try-except捕获异常，结合pathlib模块和绝对路径提升代码健壮性。

在使用 Python 进行文件操作时，经常会遇到 FileNotFoundError 错误。这个异常表示程序试图访问一个不存在的文件或路径不正确。理解这个错误的原因和解决方法，对编写健壮的文件处理代码非常重要。

什么是 FileNotFoundError？

FileNotFoundError 是 Python 内置异常之一，继承自 OSError。当尝试打开、读取或写入一个系统中找不到的文件或目录时，就会抛出此错误。常见触发场景包括：

• 文件名拼写错误
• 路径书写不正确（相对路径或绝对路径）
• 目标文件未创建或已被删除
• 工作目录与预期不符

运行以下代码时，若当前目录下没有 data.txt 文件：

with open("data.txt", "r") as f:<br>    content = f.read()

立即学习“Python免费学习笔记（深入）”；

会报错：
FileNotFoundError: [Errno 2] No such file or directory: 'data.txt'

如何排查文件路径问题

要解决该错误，关键是确认文件是否存在以及路径是否正确。可以按以下步骤检查：

Python v2.4 中文手册 chm

Python v2.4版chm格式的中文手册，内容丰富全面，不但是一本手册，你完全可以把她作为一本Python的入门教程，教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。

2

查看详情

• 使用 os.path.exists() 判断文件是否存在
• 打印当前工作目录：import os; print(os.getcwd())
• 检查路径是相对路径还是绝对路径，建议调试时使用绝对路径
• 注意操作系统间的路径分隔符差异（Windows 用反斜杠，Linux/Mac 用正斜杠）

示例代码：

import os<br>if os.path.exists("data.txt"):<br>    with open("data.txt", "r") as f:<br>        print(f.read())<br>else:<br>    print("文件不存在，请检查路径")

预防和优雅处理异常

为避免程序因文件缺失而崩溃，应使用 try-except 捕获异常，提升容错能力。

示例：

try:<br>    with open("data.txt", "r") as f:<br>        content = f.read()<br>    print(content)<br>except FileNotFoundError:<br>    print("找不到指定文件，请确认文件路径是否正确。")<br>except PermissionError:<br>    print("没有权限访问该文件。")<br>except Exception as e:<br>    print(f"发生未知错误: {e}")

实用建议

• 使用 pathlib 模块更安全地处理路径（Python 3.4+）
• 开发阶段尽量使用绝对路径定位资源
• 将配置文件或数据文件放在项目固定目录，并通过相对路径引用
• 提示用户输入文件路径时，增加存在性验证

基本上就这些。掌握路径管理和异常处理，能有效避免 FileNotFoundError 带来的困扰。

以上就是Python FileNotFoundError 文件不存在错误详解的详细内容，更多请关注php中文网其它相关文章！