Python中如何捕获文件不存在(FileNotFoundError)的异常处理?

雨强姑娘_6467

雨强姑娘_6467

2026-07-03

946人浏览

原创

应直接用 try/except 捕获 FileNotFoundError,而非预检路径存在性;它专用于文件或目录不存在场景,常见于 open() 等 I/O 操作,捕获时需避免宽泛异常掩盖真实错误。

python中如何捕获文件不存在(filenotfounderror)的异常处理?

直接用 try/except 捕获 FileNotFoundError

Python 3.3+ 中,FileNotFoundError 是 OSError 的子类,专门用于文件或目录不存在的场景。它不会自动抛出——必须显式触发,比如调用 open()、os.stat() 或 pathlib.Path().resolve() 等操作时路径无效才会触发。

最常见写法就是把文件操作包进 try 块,单独捕获 FileNotFoundError,避免误吞其他 I/O 错误(如权限拒绝、磁盘满):

try:
    with open("config.json") as f:
        data = json.load(f)
except FileNotFoundError:
    print("配置文件 config.json 未找到,使用默认配置")
    data = {"debug": False}
  • 不要用空的 except: 或宽泛的 except OSError:,否则会掩盖 PermissionError 或 IsADirectoryError 等真实问题
  • 如果同时要处理“文件不存在”和“是目录而非文件”,可并列捕获:except (FileNotFoundError, IsADirectoryError):
  • FileNotFoundError 在 Windows 和 Linux 下行为一致,无需额外适配

检查路径存在前是否需要先调用 os.path.exists()?

不需要。主动检查再操作(“check-then-act”)在多线程/多进程环境下有竞态风险:路径可能在 exists() 返回 True 后瞬间被删除,导致后续 open() 仍抛出 FileNotFoundError。更可靠的做法是直接操作 + 异常捕获(“easier to ask for forgiveness than permission”,EAFP)。

  • 用 os.path.exists() 或 pathlib.Path().exists() 只适合做预判展示(如 UI 提示),不适合替代异常处理
  • 若需区分“文件不存在”和“不是普通文件”,建议捕获 FileNotFoundError 后再用 pathlib.Path().is_file() 判断,而不是提前查类型
  • 注意:os.path.exists() 对符号链接失效路径也返回 False,而 open() 抛的是 FileNotFoundError,语义一致

pathlib 中如何优雅处理 FileNotFoundError?

pathlib 的多数方法(如 read_text()、read_bytes()、open())同样抛 FileNotFoundError,捕获方式完全一致。但它的 Path().exists() 和 Path().is_file() 不抛异常,适合组合使用。

Python Pep Authoring
Python Pep Authoring

依据官方 python/peps仓库规则起草、审阅、编辑或准备 Python 改进提案(PEP),用于处理 PEP 文本和元数据头部。

下载
from pathlib import Path

p = Path("data.csv")
try:
    content = p.read_text(encoding="utf-8")
except FileNotFoundError:
    print(f"{p} 不存在,跳过处理")
    content = ""
  • Path().read_text() 内部仍调用 open(),所以异常类型不变
  • 避免链式调用如 p.resolve().read_text():一旦 resolve() 失败(路径不存在或循环软链),抛的是 FileNotFoundError 或 FileExistsError,需单独捕获
  • Path().open() 返回标准 file object,和内置 open() 行为一致,可直接用于上下文管理

为什么有时捕获不到 FileNotFoundError?

常见原因不是语法错,而是异常根本没发生——操作本身不触发该异常。例如:os.listdir("missing_dir") 抛 FileNotFoundError,但 glob.glob("missing/*.py") 只返回空列表,从不抛异常;shutil.copy("src", "dst") 在 src 不存在时才抛,而 dst 目录不存在则可能抛 FileNotFoundError 或 NotADirectoryError,取决于具体路径层级。

  • glob.glob() 和 pathlib.Path().glob() 默认静默失败,返回空结果,不能靠捕获 FileNotFoundError 来判断模式是否匹配
  • shutil.move() 对源路径不存在抛 FileNotFoundError,但目标父目录不存在时抛 FileNotFoundError(Linux)或 OSError(Windows),行为不统一
  • 第三方库(如 pandas.read_csv())通常封装了底层 open,但可能将 FileNotFoundError 转为自己的异常(如 FileNotFoundError 或 pandas.errors.EmptyDataError),需查文档确认

真正要抓的永远是实际执行 I/O 的那一行,而不是外围逻辑。异常没被捕获,八成是那行根本没运行到。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python python 异常处理

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1851

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5064

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1809

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

30517

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3627

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3647

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1243

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2823

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程