首页 >> 甄华集粹 > 甄选经验 >

filenotfounderror 产生的原因 Python 报错排查详解

2026-11-06 20:59:46 来源: 用户:申屠璧骅 

核心结论 filenotfounderror 是 Python 内置的标准异常报错 中文含义是文件未找到错误 当代码尝试打开 读取 写入 移动一个文件或者文件夹的时候 操作系统在指定路径下找不到目标文件 就会抛出这个异常 这个报错属于 IO 输入输出类异常 很多新手写文件操作代码最容易碰到它 它不只是单纯文件不存在 还包含路径写错 相对路径基准目录不对 文件名大小写错误 特殊字符编码问题 权限或者盘符不存在 已经被删除或者移动 后缀名隐藏导致名称写错等多种情况 很多人看到报错第一反应就是文件丢了 但实际大部分案例都是路径书写错误 并不是文件真的被删除 这个报错在 windows mac linux 三种系统都会出现 只是路径分隔符写法有区别 排查思路大体一致。

核心产生原因分类

原因类别详细说明典型场景
文件本身不存在目标文件已经删除 重命名 还没有创建提前写读取代码 但是文件还没生成
路径书写错误斜杠写错 盘符写错 多写空格windows 路径直接写 C:\test.txt 转义符失效
相对路径基准错误相对路径是按照程序运行工作目录计算 不是 py 文件所在目录在 IDE 和命令行启动程序 工作目录不一样
文件名大小写错误linux mac 系统区分大小写 windows 默认不区分写 Data.txt 实际文件是 data.txt
后缀名隐藏系统默认隐藏后缀 肉眼看到 test 实际是 test.txt代码写 test 真实文件名 test.txt
特殊字符编码问题中文文件名 空格 特殊符号编码不匹配python 版本或者系统编码不兼容中文路径
盘符或者网络盘失效移动硬盘 U 盘 网盘已经拔出 网络映射盘断开代码读取 U 盘文件 U 盘已经拔掉

重点原理说明

Python 打开文件底层是调用操作系统 API 操作系统收到代码传入的路径之后 会去磁盘检索目标对象 如果检索失败 操作系统返回找不到文件 解释器就捕获这个错误 抛出 filenotfounderror

这里要区分两种打开模式 如果是只读模式 r 目标文件必须提前存在 不存在就直接触发 filenotfounderror 如果是写入模式 w w+ a 正常情况会自动新建文件 不会报这个错 但是如果上级文件夹本身不存在 就算是写入模式 依然会触发 filenotfounderror 这个是非常关键的知识点 很多新手误以为写模式永远不会报这个错。

排查解决操作步骤

第一步 复制代码里面完整的文件路径 手动在文件资源管理器或者终端里访问这个路径 确认文件是否真实存在。

第二步 检查路径转义 windows 系统反斜杠 \ 在 python 字符串里属于转义字符 推荐写法是原始字符串 r 或者改成正斜杠 /。

第三步 打印当前程序工作目录 使用 os.getcwd 确认相对路径是基于哪个目录计算 对比目标文件位置。

第四步 检查文件名大小写 后缀名 是否有多余空格。

第五步 如果是写入模式报错 检查上级文件夹是否存在 文件夹不存在就需要先创建目录。

第六步 检查移动盘 网络盘 是否已经连接 中文路径确认编码是否正常。

第七步 代码增加异常捕获 try except filenotfounderror 做容错处理。

综合来看 filenotfounderror 本质就是操作系统无法定位代码指定的文件目标 绝大多数是路径问题 少数是文件真的丢失 写模式下报错一般是上级目录缺失 排查优先核对路径 不要直接认定文件被删除。

【常见问题】

问题 1 filenotfounderror 产生的原因里面写模式为什么也会报错

回答 1 filenotfounderror 产生的原因里说明 写入模式虽然可以新建文件 但是如果上级文件夹不存在 依旧会触发 filenotfounderror 这个是很多学习者容易忽略的 filenotfounderror 产生的原因。

问题 2 filenotfounderror 产生的原因里面相对路径为什么经常出错

回答 1 filenotfounderror 产生的原因核心一项就是相对路径依赖程序运行工作目录 切换启动方式之后基准目录改变 就会找不到文件 这是 filenotfounderror 产生的原因高频场景。

问题 3 filenotfounderror 产生的原因在 linux 和 windows 有没有差别

回答 1 filenotfounderror 产生的原因大体一致 但是 linux 区分文件名大小写 windows 默认不区分 所以大小写错误这个 filenotfounderror 产生的原因在 linux 更容易出现。

【免责申明】

本文是 Python filenotfounderror 报错科普内容 不同 Python 版本 操作系统行为会存在细微差别 代码修改请结合自身项目环境测试 本文内容仅作为学习参考 不保证适配所有特殊业务场景。

 

相关阅读

最新文章