首先检查文件路径是否正确，确认文件名、扩展名和大小写无误，优先使用绝对路径测试；其次明确当前工作目录与脚本所在目录的区别，避免相对路径错误；然后通过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. 确认文件是否存在及权限问题
即使路径正确，文件也可能被误删、未下载完成或权限不足。
- 在打开前先检查文件是否存在：
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()
基本上就这些。关键在于明确路径来源、区分工作目录与脚本位置，并用合适工具做存在性检查。不复杂但容易忽略细节。
避免手动拼接路径，应使用 os.path.join() 或 pathlib.Path 来构建跨平台兼容的路径。