首先检查文件路径是否正确,确认文件名、扩展名和大小写无误,优先使用绝对路径测试;其次明确当前工作目录与脚本所在目录的区别,避免相对路径错误;然后通过os.path.exists()或pathlib.Path.exists()检查文件是否存在,并结合try-except处理异常;最后推荐使用pathlib模块提升路径操作的可读性和跨平台兼容性。

当Python程序运行时提示 FileNotFoundError,说明程序试图访问一个不存在的文件。这个错误虽然常见,但背后的原因多样,理解其根本原因并掌握解决方法对开发和调试至关重要。
1. 检查文件路径是否正确
最常见的原因是路径拼写错误或使用了错误的路径格式。
- 确认文件名、扩展名(如 .txt、.csv)是否完全匹配,包括大小写。
- 使用绝对路径临时测试,例如:
open("/Users/name/project/data.txt") 或 open("C:\project\data.txt")。 - 避免手动拼接路径,应使用 os.path.join() 或 pathlib.Path 来构建跨平台兼容的路径。
2. 理解当前工作目录
相对路径是相对于当前工作目录(Current Working Directory),而非脚本所在目录。
- 查看当前工作目录:
import os; print(os.getcwd()) - 若脚本在其他目录执行,相对路径可能失效。可通过以下方式定位到脚本所在目录:
import os
script_dir = os.path.dirname(__file__)
file_path = os.path.join(script_dir, "data.txt")
3. 确认文件是否存在及权限问题
即使路径正确,文件也可能被误删、未下载完成或权限不足。
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
- 在打开前先检查文件是否存在:
import os
if os.path.exists("data.txt"): ... - 使用 try-except 捕获异常并给出友好提示:
try:
with open("data.txt") as f:
content = f.read()
except FileNotFoundError:
print("文件未找到,请检查路径和文件是否存在。")
4. 使用 pathlib 提高可读性和可靠性
Python 3.4+ 推荐使用 pathlib 处理路径操作,更直观且跨平台。
- 示例代码:
from pathlib import Path
file_path = Path("data.txt")
if file_path.exists():
content = file_path.read_text()
else:
print("文件不存在") - 支持链式操作,如查找上级目录中的文件:
(Path(__file__).parent / "config" / "settings.json").exists()
基本上就这些。关键在于明确路径来源、区分工作目录与脚本位置,并用合适工具做存在性检查。不复杂但容易忽略细节。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










