filenotfounderror 产生的原因 Python 报错排查详解
核心结论 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 版本 操作系统行为会存在细微差别 代码修改请结合自身项目环境测试 本文内容仅作为学习参考 不保证适配所有特殊业务场景。
相关阅读
-
三星手机原生自带屏幕录制,主要依靠快捷面板里的录屏按钮操作,不用额外下载软件,新版 OneUI 还支持局部录...浏览全文>>
-
表示走的词语是描写步行移动动作的词汇,包含两字词语和四字成语,不同词语对应的走路姿态速度情绪都不一样,...浏览全文>>
-
设置微信铃声,就是给微信语音通话、视频通话设置专属来电提示音,微信支持全局统一铃声,也可以单独给某个好...浏览全文>>
-
表示索的四字词语,核心是词语里面带有索字,大多包含探索、索取、索求、索然这类含义,是语文填空和成语积累...浏览全文>>
-
查询宽带账号有官方线上 APP 客服电话 纸质单据 设备后台查看等多种办法,优先用运营商官方渠道,结果最准...浏览全文>>
-
表示景色优美的四字词语是小学语文作文、词语填空高频考点,大多是写景成语,核心用来形容自然风光秀丽好看,...浏览全文>>
-
表情简笔画核心就是以圆形作为脸部基底,通过改变眼睛、嘴巴、眉毛的线条形态,区分开心、难过、惊讶、生气等...浏览全文>>
-
苹果手机刷机,本质就是重新刷写 iOS 系统固件,一般用来解决系统卡顿、白苹果、系统故障,或者抹除全部数据...浏览全文>>
-
表格列宽和行高设置主要有拖拽手动调整右键精确数值设置自动适配三种方式,很多新手做表格遇到文字显示不全单...浏览全文>>
-
苹果充新机是二手商家圈内的叫法,官方没有这个名词,简单说就是激活过、只充过几次电,几乎没有实际使用痕迹...浏览全文>>
- 如何设置微信铃声 微信来电铃声设置教程
- 苹果什么叫充新机
- 表达一个人必须坚强的说说 走心成长版
- 苹果8还值得买吗
- 密码门锁怎么设置 基础操作详解
- 快手怎么注销账户
- 标准身材计算公式 BMI 与理想体重常用算法
- 电脑怎么重做系统 U 盘重装系统教程
- 变形金刚迷你金刚能变成什么武器 联动武装详解
- 变速箱故障灯亮起是什么原因 自动变速箱报警排查指南
- 扁的词语有哪些 组词汇总解析
- 编织篮子全教程 田字底起编基础款详解
- 手机英语怎么说 常用英文表达详解
- 边城主要内容 全书主线情节完整解读
- 避暑胜地有哪些 国内夏季清凉目的地汇总
- 壁挂电视安装高度 居家安装标准详解
- 碧玺戒指戴在哪只手指好 民俗寓意与实用选择
- 毕业生留言说说 80 句 毕业朋友圈短句合集
- 毕业班写给老师的祝福语 多版本文案汇总
- 律师函是什么意思 律师函性质与作用详解
