捕获 FileNotFoundError 的标准写法是 except FileNotFoundError:,因其精准对应文件或目录不存在场景;避免使用 except OSError: 或过时的 except IOError:,以防掩盖 PermissionError 等关键异常。

捕获 FileNotFoundError 的标准写法
Python 3.3+ 中 FileNotFoundError 是 OSError 的子类,专门用于文件或目录不存在的场景。直接用 except FileNotFoundError: 最清晰,不建议笼统捕获 OSError 或 IOError(后者在 Python 3 中已重定向为 OSError)。
常见错误是写成 except IOError: 或 except OSError:,这会掩盖其他真正需要关注的系统错误(如权限拒绝、磁盘满)。
- ✅ 正确:
except FileNotFoundError: - ❌ 模糊:
except OSError:(可能吞掉PermissionError) - ❌ 过时:
except IOError:(Python 3 中不推荐)
判断文件是否存在,该用 os.path.exists() 还是异常捕获?
优先用异常捕获(EAFP:Easier to Ask for Forgiveness than Permission),而不是提前检查(LBYL:Look Before You Leap)。因为检查和打开之间存在竞态条件——文件可能在检查后、打开前被删除或移动。
os.path.exists() 只能告诉你“此刻存在”,不能保证后续操作成功;而 try/except 是原子性处理,更可靠。
立即学习“Python免费学习笔记(深入)”;
安全 Python 代码沙箱:在隔离的沙箱中执行任意 Python 代码,预装 requests、NumPy、pandas 库。返回 stdout、stderr。
- ✅ 推荐:
try: open(path) except FileNotFoundError: - ⚠️ 谨慎:
if os.path.exists(path): open(path)(多一次系统调用,且不解决竞态) - ? 补充:若只是检查存在性(不打开),
os.path.isfile(path)比exists()更精确(排除目录)
Pathlib 中怎么处理 FileNotFoundError
使用 pathlib.Path 时,多数方法(如 read_text()、open())同样抛出 FileNotFoundError,捕获方式一致。但注意:部分方法(如 exists()、is_file())本身不抛异常,适合轻量探测。
不要误以为 Path 对象创建就会触发检查——它只是路径封装,直到你调用 IO 方法才真正访问文件系统。
- ✅ 安全读取:
try: content = Path("data.txt").read_text() except FileNotFoundError: - ✅ 探测用法:
p = Path("config.json"); if p.is_file(): ... - ❌ 错误假设:
Path("missing.log")本身不会抛异常
嵌套路径或相对路径导致的 FileNotFoundError 容易忽略什么?
异常信息里的路径是原始传入值,不自动展开或补全。如果用相对路径(如 "./logs/app.log"),报错时显示的仍是相对形式,但实际查找位置取决于当前工作目录(os.getcwd()),而非脚本所在目录。
调试时先确认当前工作目录是否符合预期;生产环境建议统一用 __file__ 构建绝对路径,避免歧义。
- ? 查当前目录:
print(os.getcwd()) - ✅ 稳定路径:
Path(__file__).parent / "data" / "input.csv" - ❌ 危险写法:
open("config.yaml")(依赖运行位置)
FileNotFoundError 可能掩盖了更底层的挂载失败或权限问题。

















