“no such file or directory”错误绝大多数不是配置问题,而是路径解析失败或文件真实缺失;jupyter不管理代码中文件路径逻辑,需检查工作目录、修正相对路径、基于notebook位置构建绝对路径,或确认外部命令是否在path中。

为什么改配置不一定能解决“No such file or directory”
这个错误绝大多数时候**不是配置问题**,而是路径解析失败或文件真实缺失。Jupyter 本身不管理你代码里 pd.read_excel('aqi_data.xlsx') 或 open('config.json') 的路径逻辑——它只负责启动内核并执行你的 Python 代码。所以“改 Jupyter 配置”不能让一个不存在的 Excel 文件突然出现,也不能修正你写错的 ../data/input.txt。真正要动的,是你的代码路径、工作目录,或环境上下文。
检查并固定当前工作目录(最常被忽略)
Jupyter 启动时的当前工作目录(os.getcwd())决定了所有相对路径的起点。它不等于 notebook 文件所在目录,也不等于你终端里 cd 进去的那个目录——它取决于你从哪启动 jupyter notebook。
- 在终端中启动前,先
cd到你希望的工作目录,再运行jupyter notebook - 在 notebook 第一个 cell 里加一行:
import os; os.chdir('/path/to/your/project'),强制切换(注意:只对当前 kernel 生效) - 用
!pwd(Linux/macOS)或!cd(Windows)命令确认当前路径,再用!ls或!dir看目标文件是否真在那儿
让路径不依赖工作目录:用 __file__ 或 Path(__file__).parent
如果你的 notebook 和数据文件放在一起(比如都在 /project/notebooks/ 下),靠 os.getcwd() 就不可靠。更稳的方式是基于 notebook 自身位置推导路径:
在 notebook 里写:
from pathlib import Path # 获取当前 notebook 所在目录 notebook_dir = Path().resolve().parent # 注意:.ipynb 文件没有 __file__,所以用此替代 # 或者更准一点(需安装 ipykernel >= 6.0): # from IPython import get_ipython # if get_ipython() is not None: # notebook_dir = Path(get_ipython().config['IPKernelApp']['connection_file']).parent.parent <p>data_path = notebook_dir / "data" / "aqi_data.xlsx" df = pd.read_excel(data_path) </p>
这样无论你从哪启动 Jupyter,只要 notebook 和 data 目录相对关系不变,路径就始终有效。
conda 环境和内核注册导致的隐性路径问题
当你用 conda 创建了新环境并注册为 Jupyter 内核后,import 行为本身不会报 “No such file or directory”,但如果你在该环境中调用了外部二进制(比如用 subprocess.run(['ffmpeg', '-i', 'input.mp4'])),而 ffmpeg 不在该环境的 $PATH 里,就会触发这个错误——看起来像文件不存在,其实是找不到可执行文件。
- 确认命令是否存在:
!which ffmpeg或!where ffmpeg(Windows) - 如果不在,要么用绝对路径调用(如
/usr/local/bin/ffmpeg),要么把对应目录加进内核的PATH(通过修改 kernel.json 的env字段) - kernel.json 位置可通过
jupyter kernelspec list查到,编辑时小心别破坏 JSON 格式
真正容易被忽略的,是错误信息里那个“文件名”其实根本不是你要读的数据文件——它可能是 shebang 解析失败的 /bin/bash\r、Python 找不到的 nul、或是 subprocess 调用的缺失命令。得先看清楚报错里那个 'xxx' 到底是谁。











