摘要Python 脚本在项目目录运行正常换个目录启动就报 FileNotFoundError常见原因是相对路径依赖当前工作目录。用 pathlib 区分脚本位置与启动位置给随脚本发布的资源设置稳定路径并用跨目录测试验证。脚本在终端里读文件一切正常放进定时任务后却出现FileNotFoundError: [Errno 2] No such file or directory: data/sample.txt第一反应往往是“定时任务没有权限”。权限确实可能是原因但先看完整报错路径。如果程序写的是Path(data/sample.txt)这个路径默认从进程当前工作目录解析定时任务的启动位置不一定是脚本所在目录。同一份代码、同一份数据在不同目录启动结果就可能不同。一、先把两个“目录”分开假设项目结构是my_job/ ├── reader.py └── data/ └── sample.txtreader.py所在目录是脚本位置Path.cwd()返回的是进程当前工作目录。你在my_job中执行python reader.py时它们碰巧一致。换到别的目录用绝对路径启动这个脚本时两者就可能不同。下面这句看起来像“脚本旁边的 data 文件夹”实际上依赖当前工作目录frompathlibimportPath textPath(data/sample.txt).read_text(encodingutf-8)路径本身没有错错在没有说清楚它相对于哪里。Python pathlib 官方文档说明了Path、resolve()等路径操作排查时把工作目录和最终解析路径都打印出来比盯着那一小段相对路径更直接。图 1默认资源用脚本目录定位命令行传入的相对路径可按当前工作目录解释但要在使用说明里写清。二、先做一个能复现的问题版本假设文件内容是这是一份随脚本存放的示例数据。把它保存到data/sample.txt。在reader.py中写frompathlibimportPathprint(cwd:,Path.cwd())print(Path(data/sample.txt).read_text(encodingutf-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_DIRPath(__file__).resolve().parent DEFAULT_INPUTSCRIPT_DIR/data/sample.txtdefchoose_input(argument:str|None)-Path:ifargumentisNone:returnDEFAULT_INPUT# A relative --input path is intentionally relative to the process CWD.returnPath(argument).expanduser().resolve()defmain(argvNone)-int:parserargparse.ArgumentParser(descriptionRead a text file with explicit path rules)parser.add_argument(--input,helpcustom absolute path, or path relative to the current working directory)argsparser.parse_args(argv)sourcechoose_input(args.input)print(fcwd:{Path.cwd()})print(fscript_dir:{SCRIPT_DIR})print(finput:{source})ifnotsource.is_file():parser.error(finput file not found:{source})print(source.read_text(encodingutf-8).strip())return0if__name____main__:raiseSystemExit(main())默认资源位置由SCRIPT_DIRPath(__file__).resolve().parent DEFAULT_INPUTSCRIPT_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”模型可能改出一个在自己当前目录恰好能工作的硬编码路径换环境后再次失败。六、为什么要专门做跨目录测试发布包附有test_reader.py。在项目目录执行python-munittest-v我在本地执行了 4 项测试全部通过。测试分别检查在脚本目录运行默认读取、从上级目录运行默认读取、从上级目录传入相对路径以及传入不存在的文件时是否报告最终路径。测试时还指定了子进程的 UTF-8 输出编码避免 Windows 终端设置影响中文断言。其中第二项最重要。只在项目目录里测一遍容易让错误的相对路径代码也“通过”。从另一个目录启动才能发现脚本对当前工作目录的依赖。七、接入真实任务前再核对两个边界__file__适用于普通脚本文件。交互式解释器、笔记本或某些打包形态不一定以同样方式提供它如果你的任务在这些环境运行要按实际入口重新定义资源根目录。另外路径正确不保证一定读得了文件。确认最终路径后还要检查文件是否存在、运行账号是否有权限以及是否遇到文本编码问题。不要把所有读取异常都改写成“找不到文件”保留不同错误类型才能快速定位。下次看到定时任务报找不到文件先打印Path.cwd()、Path(__file__).resolve().parent和最终输入路径。三行信息通常比反复修改相对路径更快定位问题。