“Config option not found”错误源于配置文件中存在Jupyter当前版本不识别的选项,如拼写错误(allow_oringin)、已废弃项(enable_nbextension)或版本不兼容(ip→bind_address),可通过--debug定位具体行,对照官方文档修正并最小化配置。

为什么会出现“Config option not found”错误
这个报错不是 Jupyter 自身崩溃,而是你在 jupyter_notebook_config.py 里写了一个 Jupyter 不认识的配置项。比如把 c.NotebookApp.allow_origin 拼成 c.NotebookApp.allow_oringin,或者用了旧版本才支持、但你当前 Jupyter 版本已移除的选项(如 c.NotebookApp.ip 在 7.0+ 已被 c.NotebookApp.bind_address 替代)。
如何快速定位非法配置项
启动时加 --debug 参数,Jupyter 会输出具体哪一行出问题:
jupyter notebook --debug
终端会打印类似这样的提示:
ValueError: Config option `c.NotebookApp.enable_nbextension` not found
说明你配置文件里写了 c.NotebookApp.enable_nbextension,但当前 Jupyter 版本(≥7.0)已废弃该选项。
常见误用配置项包括:
-
c.NotebookApp.ip→ 应改用c.NotebookApp.bind_address -
c.NotebookApp.port→ 仍可用,但若设为0且系统无权限自动选端口,也会触发类似报错 -
c.NotebookApp.open_browser→ 正确,但拼错成c.NotebookApp.open_brower就会报错 -
c.NotebookApp.notebook_dir→ 正确,但路径含中文或未转义空格会导致解析失败,有时也表现为“option not found”类模糊提示
修复配置文件的实操步骤
先确认你改的是哪个配置文件:
jupyter --config-dir
进入该目录,用文本编辑器打开 jupyter_notebook_config.py,重点检查:
- 所有以
c.开头的行,对照官方文档核对选项名:Notebook config docs - 注释掉暂时不用的配置项,逐条启用测试
- 避免直接复制网上过时教程的整段配置——尤其注意 Jupyter 6.x 和 7.x 的 breaking changes
- 如果不确定某项是否还存在,运行
python -c "from notebook import notebookapp; print(notebookapp.NotebookApp.class_traits())"查看当前版本实际支持的配置项
预防下次再踩坑
配置文件不是越长越好,最小化起步更安全:
- 首次生成配置:运行
jupyter notebook --generate-config,它只生成空骨架,不带任何预设值 - 每次只加 1 行配置,保存后重启验证
- 升级 Jupyter 后(如从 6.x 升到 7.x),别复用旧配置文件,重新生成再按需迁移
- Windows 用户特别注意:路径中含空格或中文时,必须用双引号包裹,例如
c.NotebookApp.notebook_dir = "D:/my work/notebooks"
最常被忽略的是版本兼容性——同一份配置,在 Jupyter 6.5 能跑,7.2 就可能直接报 “Config option not found”,因为底层配置类结构变了。


















