直接删掉 .jupyter 目录是最彻底的重置方式,因其集中存储所有用户级配置,删除后 jupyter 将完全回归当前版本的出厂逻辑,而非旧版默认行为。

直接删掉 .jupyter 目录是最彻底的重置方式
Jupyter Notebook 的所有用户级配置(包括默认路径、密码、扩展设置、自定义内核注册等)都集中在 ~/.jupyter 这个隐藏目录里。只要这个目录存在,Jupyter 就会优先读取其中的 jupyter_notebook_config.py 或 jupyter_server_config.py,哪怕内容为空或全是注释,也会覆盖默认行为。
所以「重置」不是改回某几行配置,而是让 Jupyter 完全回归出厂逻辑——即不加载任何用户配置。
- Windows:打开文件资源管理器,地址栏粘贴
%USERPROFILE%\.jupyter,删掉整个.jupyter文件夹 - macOS / Linux:终端执行
rm -rf ~/.jupyter - 删之前建议备份(比如压缩成
.jupyter_backup.zip),以防你其实依赖了某些没意识到的配置(比如自定义内核或 token 配置)
jupyter notebook --generate-config 不是重置,而是重建空配置
很多人误以为执行 jupyter notebook --generate-config 就等于“恢复默认”,其实它只是生成一份带大量注释的模板文件,并不会清空已有配置,更不会删除旧的 jupyter_server_config.py 或 jupyter_nbconvert_config.py。
尤其注意:JupyterLab 3.0+ 和新版 Notebook(基于 jupyter-server)默认读取的是 jupyter_server_config.py,而老教程教改的 jupyter_notebook_config.py 可能已被忽略——删错文件会导致你以为重置了,实际配置还在生效。
- 执行该命令后,检查
~/.jupyter/下是否同时存在jupyter_notebook_config.py和jupyter_server_config.py;如有,两个都得删 - 如果只删了其中一个,Jupyter 可能静默 fallback 到另一个,路径、密码、端口等仍按旧规则运行
快捷方式和启动命令里的硬编码路径必须手动清理
即使配置文件全删了,如果你之前修改过开始菜单快捷方式的“目标”字段(比如加了 --notebook-dir="D:\myproject"),或者在终端里习惯用 jupyter notebook --notebook-dir=E:\notebooks 启动,那每次启动时这些参数都会强制覆盖默认行为。
- Windows 开始菜单中右键 Jupyter 快捷方式 → 属性 → 查看“目标”框,删掉所有
--notebook-dir、--port、--no-browser等参数 - 检查是否在 shell 配置文件(如
~/.bashrc、~/.zshrc或 Windows 的环境变量)里 alias 了 jupyter 命令,比如alias jn='jupyter notebook --notebook-dir=...',这类 alias 会持续生效 - Anaconda Navigator 启动的 Jupyter 也可能缓存上次工作目录,重启 Navigator 或清除其本地状态(
%LOCALAPPDATA%\anaconda\navigator\下相关 JSON)
重置后首次启动仍可能“看起来不像默认”
删掉 .jupyter 后第一次运行 jupyter notebook,你会看到:
- 自动打开浏览器,但地址可能是
http://localhost:8888/tree?token=xxx(而不是无 token 的旧版)——这是新版默认安全机制,不是配置残留 - 工作目录是当前终端所在路径,不是 C:\Users\xxx ——这才是真正的“无配置默认行为”
- 没有密码提示?因为 token 认证已启用;想关 token,必须新建配置并显式设
c.ServerApp.token = '',这不是默认值
真正容易被忽略的点:Jupyter 的“默认”本身已随版本演进。2026 年的默认行为(基于 jupyter-server、token 认证、ServerApp 类配置项)和 2020 年的 NotebookApp 默认完全不同——重置不是回到旧版,而是回到当前安装版本的原始语义。











