首先检查文件路径是否正确,确认文件名、扩展名和大小写无误,优先使用绝对路径测试;其次明确当前工作目录与脚本所在目录的区别,避免相对路径错误;然后通过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免费学习笔记(深入)”;
- 在打开前先检查文件是否存在:
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()
基本上就这些。关键在于明确路径来源、区分工作目录与脚本位置,并用合适工具做存在性检查。不复杂但容易忽略细节。










