Jupyter Notebook默认启动目录配置不生效问题排查

环境配置 #

• Jupyter Notebook 安装在虚拟环境 ana-env 中
• 默认启动目录为 C:\Users\<username>

问题现象 #

• 修改配置文件后，Notebook 仍在 C:\Users\<username> 启动，启动日志明确显示：[I ServerApp] Serving notebooks from local directory: C:\Users\<username>
• 命令行执行 jupyter notebook --notebook-dir="d:\\" 时，可成功在 D:\ 启动服务
• 启动过程中出现警告：[W ServerApp] A _jupyter_server_extension_points function was not found...

1. 配置文件中c.ServerApp.root_dir未生效的原因 #

常见触发原因包括：

• 配置文件路径错误：你原定位的路径缺少反斜杠，正确路径应为 C:\Users\<username>\.jupyter\jupyter_notebook_config.py
• 配置项未解除注释：默认配置文件中c.ServerApp.root_dir行前带有#注释符，未移除的话配置不会被加载
• 虚拟环境配置隔离：虚拟环境可能拥有独立的配置目录，你修改的是全局配置而非ana-env环境对应的配置文件。可在激活虚拟环境后执行jupyter --config-dir，查看当前生效的配置目录路径

2. 启动警告与目录问题的关联 #

该警告源于部分旧版Jupyter扩展不兼容当前ServerApp架构，与启动目录配置失效无直接关联。它不会影响核心配置加载，可暂时忽略；若需消除警告，可排查并卸载未兼容的扩展插件。

3. 确保配置目录生效的步骤 #

按以下流程操作即可解决：

1. 确认正确配置文件：激活ana-env后执行jupyter notebook --generate-config，生成并查看当前环境生效的配置文件路径
2. 修改并激活配置项：打开配置文件，找到#c.ServerApp.root_dir = ''行，移除开头的#，修改为c.ServerApp.root_dir = 'd:\\'（或使用正斜杠'd:/'避免转义）
3. 验证配置加载：执行jupyter notebook --show-config，检查输出中ServerApp.root_dir的值是否为d:\，确认配置已被正确识别
4. 排除参数覆盖：检查启动快捷方式、脚本等是否附加了--notebook-dir参数，该参数会优先于配置文件设置
5. 重启服务：保存配置文件后，重启Jupyter Notebook服务

内容的提问来源于stack exchange，提问作者Ellick