新版Jupyter需改c.ServerApp.root_dir,旧版改c.NotebookApp.notebook_dir;先运行jupyter notebook --generate-config生成配置文件,再删注释、填绝对路径(正斜杠或双反斜杠)、确保目录存在且快捷方式未硬编码%USERPROFILE%。

直接改 jupyter_notebook_config.py 里的 c.ServerApp.root_dir(新版)或 c.NotebookApp.notebook_dir(旧版),再确保快捷方式没硬编码 %USERPROFILE%,三处齐备才生效。
怎么生成并定位 jupyter_notebook_config.py
这个文件不是自带的,必须手动触发生成。在 Anaconda Prompt(不是普通 CMD 或 VS Code 终端)里运行:
jupyter notebook --generate-config
它会输出类似 C:\Users\你的用户名\.jupyter\jupyter_notebook_config.py 的路径。重点:
• 不同 Python 环境(比如 conda 多环境、pip 单独装的 jupyter)可能加载不同位置的配置
• 路径里有中文用户名(如 C:\Users\张三)时,旧版 Windows 可能解析失败,建议目标路径避开中文
• 没运行这行命令就直接去 C:\Users 下翻找 → 文件根本不存在
c.ServerApp.root_dir 还是 c.NotebookApp.notebook_dir?
Jupyter Notebook 7.x+ 已将核心配置从 NotebookApp 迁移到 ServerApp,c.NotebookApp.notebook_dir 在新版中已弃用或被忽略。
- 新版(如 7.4.5):必须改
c.ServerApp.root_dir = 'D:/Jupyter_Projects',删掉前面的#,且该行不能缩进 - 旧版(如 6.x):仍认
c.NotebookApp.notebook_dir - 不确定版本?打开配置文件搜
root_dir和notebook_dir两个关键词,优先改带root_dir的那行
路径写法和目录存在性检查
写错路径格式或目标文件夹不存在,会导致 Jupyter 启动失败、静默退出,或回退到默认路径。
- 路径必须用英文单引号包裹:
'D:/Jupyter_Projects'或r'D:\Jupyter_Projects'(r前缀可避免反斜杠转义问题) - 绝对禁止只写
'D:\Jupyter_Projects'—— 单个\会被 Python 当作转义符,比如\J变成换行符 - 目标文件夹(如
D:\Jupyter_Projects)必须提前在资源管理器里手动创建好,Jupyter 不会自动建目录 - 路径中避免空格和中文,尤其不要用 OneDrive 或 iCloud 同步目录,部分同步服务会干扰内核启动
为什么改了配置还是开在 C 盘?
因为快捷方式“目标”字段末尾硬编码了 %USERPROFILE%,它会覆盖配置文件设置。
- 找到开始菜单 → Anaconda3 → Jupyter Notebook 快捷方式 → 右键 → 属性 → “目标”栏
- 把末尾的
%USERPROFILE%整段删掉(注意保留前面的引号和空格结构) - 如果想同时指定起始路径,可改成:
"C:\Users\...\jupyter-notebook.exe" "D:\Jupyter_Projects" - 改完点“应用”,再重新通过快捷方式启动,而不是用命令行
最易被忽略的是:改完配置后没关掉所有 Jupyter 进程(包括后台托盘图标),旧进程缓存未清,新配置不生效。建议任务管理器结束所有 python.exe 和 jupyter-notebook.exe 进程后再试。


















