Python读取文件报错FileNotFoundError或PermissionError怎么解决?

周予安
周予安
发布时间:2026-11-18 | 3人浏览过
原创

全面分析Python读取文件时报FileNotFoundError与PermissionError的核心原因,提供清晰的排查流程、相对路径工作机制辨析、解决步骤与防御式编程规范,内含多幅图解与实战示例。

在 Python 中读取文件时,FileNotFoundError: [Errno 2] No such file or directory 和 PermissionError: [Errno 13] Permission denied 是最容易出现的两类异常。它们的核心解决路径非常明确:FileNotFoundError 多数源于路径字符串写错、系统隐藏扩展名干扰,或终端启动时的“当前工作目录”与脚本所在文件夹不一致,使用内置模块 pathlib 构建锚定脚本自身位置的绝对路径即可彻底解决;而 PermissionError 则主要源于把文件夹路径当作普通文件打开、文件已被 Office 等软件独占加锁,或操作系统账户对该路径缺少读取权限。本文将系统拆解这两类报错的具体机理,提供清晰的排查流程与可落地的修复方案。

一、彻底解决 FileNotFoundError(文件未找到错误)

当 Python 执行 open(file_path) 时,操作系统如果未能根据提供的路径定位到有效文件,就会抛出 FileNotFoundError。排查该问题需要从文件路径的准确性与解析上下文两方面入手。

1. 逐步排查与修复流程

遇到 FileNotFoundError 时,切忌盲目在代码里反复修改文件名,建议按照以下固定顺序排查:

  1. 核对文件名与真实扩展名: 在 Windows 默认设置下,“隐藏已知文件类型的扩展名”常处于勾选状态。用户以为文件名为 data.txt,但其实际名称是 data.txt.txt;在代码中传入 "data.txt" 就会直接抛出未找到错误。
  2. 检查路径大小写与特殊转义字符: Linux 与 macOS 对文件名大小写严格敏感(Data.csv 与 data.csv 属于不同文件)。在 Windows 环境下,直接编写包含反斜杠的字符串(如 "C:\new_folder\test.txt")容易将 \n 或 \t 识别为转义换行与制表符,应当改用原始字符串 r"C:\new_folder\test.txt" 或正斜杠 "C:/new_folder/test.txt"。
  3. 打印并核对当前工作目录(CWD): 执行 import os; print(os.getcwd()),确认当前执行环境所处的根起点是否与预想中的相对路径基准一致。
  4. 转换为基于脚本所在位置的绝对路径: 通过 pathlib.Path(__file__).resolve().parent 构建路径,消除对终端工作目录的依赖。
Python读取文件报错FileNotFoundError或PermissionError怎么解决?
图 1:FileNotFoundError 标准排查路径与最终锚定方案

2. 认知辨析:“文件与代码在同一目录就一定能直接打开”为什么会失效?

许多初学者存在一个认知误区:“既然我的 script.py 和 data.txt 保存在同一个文件夹内,直接写 open('data.txt') 就绝不可能报错”。这个说法看似非常符合直觉,但它仅在一种前提下成立:你的终端命令是在该脚本所在文件夹内直接触发的。

在 Python 中,所有相对路径(如 open('data.txt') 或 open('./data.txt'))的寻址起点都不是当前 Python 脚本所在的物理位置,而是当前工作目录(Current Working Directory,简称 CWD)。如果你在项目根目录 /my_project/ 下执行了 python src/scripts/script.py,此时的 CWD 是 /my_project/。Python 会尝试去 /my_project/data.txt 寻找文件,而不是 /my_project/src/scripts/data.txt,于是立即触发 FileNotFoundError。

Python读取文件报错FileNotFoundError或PermissionError怎么解决?
图 2:CWD 与脚本位置脱节导致的寻址失败对比图

3. 稳妥的代码修复示例

推荐全面淘汰字符串手动拼接路径的写法,改用 Python 3 标准库 pathlib:

from pathlib import Path

# 获取当前正在执行的 Python 文件所在的绝对目录
CURRENT_DIR = Path(__file__).resolve().parent

# 基于当前脚本目录拼接目标数据文件
target_file = CURRENT_DIR / "data.txt"

print(f"解析后的实际绝对路径: {target_file}")

# 安全读取
if target_file.is_file():
    with open(target_file, "r", encoding="utf-8") as f:
        content = f.read()
        print("读取成功,内容前50字符:", content[:50])
else:
    print(f"错误: 目标文件不存在 -> {target_file}")

二、彻底解决 PermissionError(权限拒绝错误)

PermissionError: [Errno 13] Permission denied 表示操作系统拒绝了当前 Python 进程对目标节点发起的访问请求。很多人误以为这一定是“操作系统的管理员权限不足”,实际上在日常开发中,绝大多数 PermissionError 是由另外几种具体行为引起的。

1. 四类常见成因与排查方向

  • 成因一:误把文件夹路径传给了 open()
    在 Linux、macOS 或 Windows 下,直接对一个目录执行 open('/path/to/folder'),系统均会抛出 PermissionError: [Errno 13] Permission denied: '/path/to/folder'(在某些系统下可能为 IsADirectoryError)。这是最常见的低级疏忽。
  • 成因二:目标文件被其他进程独占占用
    在 Windows 系统中,如果目标 .xlsx 或 .csv 文件正处于打开状态(例如使用 Microsoft Excel 或 WPS 正在编辑),操作系统会对该文件施加文件锁。此时 Python 尝试以写入("w")或追加模式("a")打开该文件时,就会立即抛出 PermissionError。
  • 成因三:文件属性为“只读”却使用了写模式
    如果本地文件被标记为 Read-Only(只读属性),或者文件所在目录属于受保护的系统级目录(例如 Windows 的 C:\Program Files,Linux 的 /etc/),非特权 Python 进程试图以修改方式访问就会被拒绝。
  • 成因四:父级目录缺少必要遍历/读取权限
    在 Linux/macOS 环境下,即使文件本身拥有 644 权限,但如果其上层目录缺少执行权限 x(目录缺少 x 权限会导致无法进入),Python 同样无法检索到该文件并抛出权限拒绝。
Python读取文件报错FileNotFoundError或PermissionError怎么解决?
图 3:PermissionError 核心诱因分类与对应解决方案

2. 针对 PermissionError 的防范代码

在涉及可能被外部修改或类型不确定的文件时,务必在打开前进行属性校验,并做好异常兜底:

from pathlib import Path

file_path = Path("reports/summary.csv")

if not file_path.exists():
    print(f"路径不存在: {file_path}")
elif file_path.is_dir():
    print(f"错误: 目标是一个目录,不能当成文件读取: {file_path}")
else:
    try:
        # 只读模式读取,避免意外请求写入权限
        with open(file_path, mode="r", encoding="utf-8") as f:
            data = f.read()
            print("读取成功,数据行数:", len(data.splitlines()))
    except PermissionError as e:
        print(f"读取失败:权限不足或文件被独占。详情: {e}")
        print("建议排查:1. 该文件是否正在 Excel 中处于打开状态? 2. 当前账户是否具有该文件读取权限?")

三、稳健的防御式编程规范

在生产环境与日常工程中,完全杜绝文件读取报错的根本方式是践行规范的文件操作范式。以下为三条核心准则:

1. 始终使用上下文管理器(with 语句)

直接调用 f = open(...) 并在后续手动 f.close() 是极其脆弱的做法。如果读取过程中抛出格式解析异常,close() 就会被直接跳过,导致操作系统文件句柄泄露、文件持续被占用。随后的代码重试就会因文件锁触发 PermissionError。使用 with open(...) as f: 能确保无论发生何种异常,文件句柄均会在退出作用域时被操作系统可靠关闭。

2. 优先采用 EAFP(基于异常捕获)还是 LBYL(先检查后执行)?

Python 社区提倡 “Easier to ask for forgiveness than permission” (EAFP),即直接尝试执行并在 try-except 中捕获具体异常。因为即便在调用 os.path.exists() 校验文件存在的瞬间文件确实存在,在执行下一行 open() 时,该文件依然有可能被其他进程瞬间删除或修改属性(发生 Race Condition 竞态条件)。因此,最严密的方案是结合 try-except 明确拦截 (FileNotFoundError, PermissionError):

from pathlib import Path

def read_text_safe(filepath: Path) -> str | None:
    try:
        with open(filepath, "r", encoding="utf-8") as f:
            return f.read()
    except FileNotFoundError:
        print(f"[错误] 未能找到文件: {filepath.resolve()}")
    except PermissionError:
        print(f"[错误] 拒绝访问: 目标可能是目录、已被独占或权限受限: {filepath.resolve()}")
    except UnicodeDecodeError:
        print(f"[错误] 编码不匹配,请尝试 'gbk' 或其他编码格式")
    except OSError as e:
        print(f"[错误] 其他系统I/O异常: {e}")
    return None

四、核心排查对照与总结

为了帮助读者在遇到报错时快速定位病灶,下表对两类异常进行了横向对比:

异常类型 常见表现 / 错误信息 首要检查项 标准修复手段
FileNotFoundError [Errno 2] No such file or directory 1. 真实扩展名是否重复(.txt.txt)
2. 相对路径起点的 CWD 是否和脚本位置一致
使用 Path(__file__).resolve().parent 构造基于脚本位置的绝对路径。
PermissionError [Errno 13] Permission denied 1. 目标路径是否其实是个文件夹
2. 是否正被 Excel 等软件打开占用
3. 是否对只读文件使用了写模式
使用 Path.is_file() 确保是文件;关闭独占软件;只读时使用 mode='r';必要时修正文件读权限。
Python读取文件报错FileNotFoundError或PermissionError怎么解决?
图 4:Python 文件 I/O 稳健编码三大核心规范

总结: 当代码遭遇 FileNotFoundError 时,不要再怀疑代码逻辑本身,直接通过 Path(__file__).resolve().parent 构建物理绝对路径,并确认文件没有多余的隐藏扩展名;当遭遇 PermissionError 时,优先确认传入的不是文件夹路径,并检查该文件是否正被 Excel 等工具打开锁死。遵循这两条排查规律,绝大多数文件读取异常都能在两分钟内迎刃而解。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表