Python 脚本本地能跑，定时任务却找不到文件？先查相对路径-育师

摘要：Python 脚本在项目目录运行正常，换个目录启动就报 FileNotFoundError，常见原因是相对路径依赖当前工作目录。用 pathlib 区分脚本位置与启动位置，给随脚本发布的资源设置稳定路径，并用跨目录测试验证。

脚本在终端里读文件一切正常，放进定时任务后却出现：

FileNotFoundError: [Errno 2] No such file or directory: 'data/sample.txt'

第一反应往往是“定时任务没有权限”。权限确实可能是原因，但先看完整报错路径。如果程序写的是Path("data/sample.txt")，这个路径默认从进程当前工作目录解析；定时任务的启动位置不一定是脚本所在目录。

同一份代码、同一份数据，在不同目录启动，结果就可能不同。

一、先把两个“目录”分开

假设项目结构是：

my_job/ ├── reader.py └── data/ └── sample.txt

reader.py所在目录是脚本位置；Path.cwd()返回的是进程当前工作目录。你在my_job中执行python reader.py时，它们碰巧一致。换到别的目录，用绝对路径启动这个脚本时，两者就可能不同。

下面这句看起来像“脚本旁边的 data 文件夹”，实际上依赖当前工作目录：

frompathlibimportPath text=Path("data/sample.txt").read_text(encoding="utf-8")

路径本身没有错，错在没有说清楚它相对于哪里。Python pathlib 官方文档说明了Path、resolve()等路径操作；排查时，把工作目录和最终解析路径都打印出来，比盯着那一小段相对路径更直接。

图 1：默认资源用脚本目录定位；命令行传入的相对路径可按当前工作目录解释，但要在使用说明里写清。

二、先做一个能复现的问题版本

假设文件内容是：

这是一份随脚本存放的示例数据。

把它保存到data/sample.txt。在reader.py中写：

frompathlibimportPathprint("cwd:",Path.cwd())print(Path("data/sample.txt").read_text(encoding="utf-8"))

在项目目录里执行python reader.py，通常能读到数据。随后切换到项目的上级目录，使用脚本的完整路径启动，例如：

python "C:\path\to\my_job\reader.py"

这时脚本文件仍然是原来的reader.py，但data/sample.txt会从上级目录寻找。这个示例路径只是占位，实际运行时要换成你的绝对路径。

出现错误前，打印的cwd值往往已经说明问题。要注意，找不到文件和没有读取权限是两类错误，不能仅凭任务运行失败就认定权限不足。

三、资源跟着脚本走，就用脚本位置定位

下面这版是可运行的完整示例。使用 Python 3.10 或更新版本，reader.py与data/sample.txt按前面的结构存放，不需要第三方包。

importargparsefrompathlibimportPath SCRIPT_DIR=Path(__file__).resolve().parent DEFAULT_INPUT=SCRIPT_DIR/"data"/"sample.txt"defchoose_input(argument:str|None)->Path:ifargumentisNone:returnDEFAULT_INPUT# A relative --input path is intentionally relative to the process CWD.returnPath(argument).expanduser().resolve()defmain(argv=None)->int:parser=argparse.ArgumentParser(description="Read a text file with explicit path rules")parser.add_argument("--input",help="custom absolute path, or path relative to the current working directory")args=parser.parse_args(argv)source=choose_input(args.input)print(f"cwd:{Path.cwd()}")print(f"script_dir:{SCRIPT_DIR}")print(f"input:{source}")ifnotsource.is_file():parser.error(f"input file not found:{source}")print(source.read_text(encoding="utf-8").strip())return0if__name__=="__main__":raiseSystemExit(main())

默认资源位置由：

SCRIPT_DIR=Path(__file__).resolve().parent DEFAULT_INPUT=SCRIPT_DIR/"data"/"sample.txt"

确定。无论你在哪个目录启动，默认数据都相对reader.py所在目录查找。

脚本也支持--input。这里的规则刻意不同：用户显式传入的相对路径按当前工作目录解析。这符合很多命令行工具的习惯，也方便在批处理任务中指定外部文件。为了不让这个差别变成隐藏规则，程序会打印最终解析出的input路径。

默认读取失败时，错误信息同样带完整路径，便于核对是否真的部署了数据文件。

四、实际运行：换个目录再试一次

先在项目目录执行：

python reader.py

再切换到上级目录，用reader.py的绝对路径启动：

python "C:\path\to\my_job\reader.py"

两次运行的cwd可以不同，script_dir与默认input应指向同一个项目位置，最后都打印：

这是一份随脚本存放的示例数据。

如果数据在脚本目录外，可以传绝对路径：

python "C:\path\to\my_job\reader.py" --input "D:\data\today.txt"

若传相对路径，例如--input data/today.txt，则会从执行命令时的当前工作目录查找。定时任务里最好明确配置其启动目录，或者传入经过核对的绝对路径，减少环境变化带来的歧义。

五、给 AI 的提示词：要求它先找“路径基准”

如果你正在让 AI 帮忙排查原有脚本，可以把问题描述成这样：

请检查这段 Python 代码为什么在手动运行时能找到文件， 在定时任务或从其他目录启动时却找不到。 请先区分： 1. 当前工作目录 Path.cwd()； 2. 脚本文件所在目录 Path(__file__).resolve().parent； 3. 传入的 --input 路径是绝对路径还是相对路径。 要求： - 给出最小复现步骤，分别从脚本目录和上级目录启动； - 打印最终解析的文件路径； - 如果文件是随脚本发布的资源，用脚本位置定位； - 如果文件是用户传入的外部数据，明确相对路径的解析规则； - 保留原始数据，不添加自动移动或删除文件的行为； - 说明除了路径问题，还需要怎样区分文件不存在与权限不足。 不要先猜“定时任务权限不够”。

这样的提示词能让 AI 给出可验证的排查步骤。只说“帮我修 FileNotFoundError”，模型可能改出一个在自己当前目录恰好能工作的硬编码路径，换环境后再次失败。