脚本在编辑器里跑得好好的,双击运行或者换个目录一启动就抛出 FileNotFoundError,打开报错信息一看,路径明明就是自己写的那三行相对的 config.ini。这是 Python 初学者最常遇到的一类问题,也是最容易被误判成一类问题:很多人第一反应是"权限不够"或者"文件被删了",反复检查后发现文件老老实实待在原地,出问题的只是程序启动时站在哪个目录里。
两个"当前目录"其实不是一个东西
代码里写的相对路径,永远相对于进程的当前工作目录(current working directory,简称 cwd)解析,而不是相对于脚本文件所在的目录。这两者在某些情况下恰好重合,于是问题被掩盖;一旦重合条件被破坏,路径立刻失效。
重合的典型场景是在终端里先 cd 到脚本目录,再执行 python myscript.py。此时终端的工作目录和脚本目录是同一个,相对路径自然能找到旁边的配置文件。而下面这些情况都会让两者分家:
- 在项目根目录执行
python scripts/run.py,工作目录是项目根,脚本在scripts子目录里 - 用 IDE 的"运行"按钮启动,IDE 往往把工作目录设成项目根目录,而不是 .py 文件所在目录
- 在定时任务、计划任务、开机自启、桌面快捷方式里启动,工作目录可能是用户主目录、系统目录,甚至是一个与项目毫无关系的路径
- 在别的程序里通过子进程调用你的脚本,工作目录由父进程决定
所以"我本地能跑,换种启动方式就不行"不是玄学,只是启动位置变了。
为什么会"文件就在旁边"却找不到
可以把整个解析过程想象成两步:先确定起点,再拼上你写的相对路径。起点就是当前工作目录,你写的 config.ini 只是被贴在起点后面。起点如果是 /home/user,Python 找的就是 /home/user/config.ini;起点如果是 C:WindowsSystem32,那找的就是系统目录下的 config.ini。文件确实在脚本旁边,但程序压根没往那里看。
理解这一点之后,排查方向就很清楚了:要么把起点改对,要么别依赖起点,直接把路径拼成绝对路径。
排查第一步:把当前工作目录打印出来
在报错的那一行之前,插入几行打印,先确认程序实际站在哪里。这是成本最低、信息量最大的一步:
from pathlib import Path
print("当前工作目录:", Path.cwd())
print("脚本文件位置:", Path(__file__).resolve())
print("脚本所在目录:", Path(__file__).resolve().parent)
Path.cwd() 返回进程当前工作目录,__file__ 是当前脚本文件的路径。两者打出来一对比,问题往往当场就暴露了:比如 cwd 是项目根目录,而脚本在 scripts 子目录里,那么相对路径 config.ini 实际指向的是项目根下的 config.ini,而不是 scripts 下的那个。
使用 os.path 的写法等价:
import os
print("当前工作目录:", os.getcwd())
print("脚本所在目录:", os.path.dirname(os.path.abspath(__file__)))
os.path.abspath(__file__) 把可能相对的 __file__ 转成绝对路径,再取目录部分。少了 abspath 这一步,在某些启动方式下 __file__ 本身就是相对的,结果会再次依赖工作目录,绕回原来的问题。
排查第二步:看清路径是怎么拼出来的
打印出两个目录之后,接下来要确认代码里那句路径到底拼成了什么。路径拼接最常见的坑是直接用字符串相加或斜杠连接,比如 base + "/config.ini"。这在 Windows 上可能凑巧能用,但也容易拼出多余的分隔符、混用正反斜杠,或者在 base 为空时拼出一个从根目录开始的路径。
正确的做法是交给路径库处理,它会根据当前系统选择合适的分隔符,也会自动处理末尾斜杠的问题。
pathlib 的写法更简洁,推荐优先使用:
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent
CONFIG_PATH = BASE_DIR / "config.ini"
print("准备读取:", CONFIG_PATH)
/ 运算符在这里表示拼接路径,不是除法,读起来接近自然表达。如果配置文件不在脚本同级,而在上一级的某个目录里,可以写成 BASE_DIR.parent / "conf" / "config.ini",层级关系一目了然。
os.path 的等价写法:
import os
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
CONFIG_PATH = os.path.join(BASE_DIR, "config.ini")
print("准备读取:", CONFIG_PATH)
两种写法都实现了同一个思路:以脚本文件位置为锚点,拼出绝对路径。这样无论从哪个目录启动、由谁调用、是不是被计划任务拉起来,指向的目标都不变。
这里需要区分一种情况:如果配置文件的语义本来就是"用户当前目录下的配置",那依赖工作目录反而是对的,改用脚本位置反而是错的。判断标准很简单——这个文件是跟着代码一起分发的,还是跟着使用者走的。跟着代码走的用脚本位置,跟着使用者走的用工作目录或用户主目录。
排查第三步:确认目标文件是否真的存在
路径拼对了,也不代表文件就在那里。最后一步是直接验证目标路径的状态,而不是靠肉眼比对目录树:
from pathlib import Path
CONFIG_PATH = Path(__file__).resolve().parent / "config.ini"
print("是否存在:", CONFIG_PATH.exists())
print("是否文件:", CONFIG_PATH.is_file())
print("绝对路径:", CONFIG_PATH)
exists() 为 False 时,把打印出来的绝对路径复制到文件管理器地址栏或终端里核对一次,通常能发现两类问题:文件名大小写不一致(Linux 下区分大小写,Windows 下不区分,在 Windows 上写好的脚本搬到 Linux 就报错),或者扩展名被系统隐藏了,实际文件叫 config.ini.txt。
如果 exists() 为 True 但读取仍失败,方向就要从"路径问题"转到"权限问题"或"文件编码问题",这是另一条排查线,不必在路径上继续纠缠。
一套可以固定下来的排查顺序
把这套流程记成固定顺序,下次遇到同类报错可以少走弯路:
先打印 Path.cwd() 和 Path(__file__).resolve().parent,看两者是否一致,判断问题是出在启动位置还是预期本身有偏差。再打印真正用于打开文件的那个路径变量,确认拼接结果是一个完整的绝对路径,而不是一条还带着相对片段的字符串。最后用 exists() 和 is_file() 验证目标是否落在预期位置,并核对大小写与扩展名。三步走完,路径问题基本能定性。
顺带养成两个习惯,能省掉大量重复排查。第一,凡是读取与代码一起分发的资源文件,一律基于脚本位置拼绝对路径,不要图省事写裸相对路径。第二,在打开文件之前把最终路径打印一次,或者包在 try 里捕获 FileNotFoundError 并输出该路径,让报错信息自己说明它找的是哪里——这比事后猜测高效得多。








