0

0

如何在 Windows 上更改 Jupyter Notebook 的默认根目录

花韻仙語

花韻仙語

发布时间:2026-01-19 11:17:11

|

384人浏览过

|

来源于php中文网

原创

如何在 Windows 上更改 Jupyter Notebook 的默认根目录

本文介绍三种可靠方法修改 jupyter notebook 启动时的默认工作目录,包括命令行临时指定、配置文件永久设置(适配新版 jupyter 的 `serverapp` 配置迁移),并特别说明网络驱动器(如映射的 `d:` 盘)的注意事项。

在 Windows 系统中,Jupyter Notebook 默认启动目录为当前命令行所在路径(若直接双击启动,则通常是用户主目录)。若需固定使用特定目录(例如 D:\_Travail\Python\Jupyter_projects),有以下三种经验证有效的方法,请优先尝试方法一(即时生效、无需配置)

✅ 方法一:命令行启动时指定目录(推荐,最简单可靠)

打开 Anaconda Prompt(或任意终端,确保 jupyter 命令可用),执行:

jupyter notebook --notebook-dir "D:\_Travail\Python\Jupyter_projects"
⚠️ 注意:路径中使用英文双引号包裹,支持正斜杠 / 或转义反斜杠 \\,但不建议仅用单个 \(易被误解析为转义符)。 ✅ 优势:无需修改配置文件,每次可灵活切换;兼容网络驱动器(如映射的 D: 盘),只要该路径对当前用户可读写且网络连接稳定即可。

✅ 方法二:通过配置文件永久设置(适配 Jupyter ≥ 6.4+)

新版 Jupyter(尤其是 Jupyter Server 2.0+)已将 notebook_dir 迁移至 ServerApp 配置项。请按以下步骤操作:

  1. 生成或定位配置文件:
    在终端运行

    jupyter server --generate-config

    将生成 jupyter_server_config.py(通常位于 ~\.jupyter\jupyter_server_config.py)。

  2. 编辑该文件,取消注释并修改以下行:

    DESTOON一起发货源模板
    DESTOON一起发货源模板

    一起发货源模板是需要基于destoon默认模板上添加替换的,所以先要上传一份官方默认的模板和风格,然后再进行上传替换。使用说明:1、下载模板上传根目录就可以了!2、网站后台更改模板目录及风格目录:系统维护—>网站设置—>基本设置—>网站默认风格和网站默认模板都选择新模板的目录—>确定。3、更新模板缓存:系统维护—>模板风格—>重建缓存。4、如果模板还是没变,系统

    下载
    c.ServerApp.root_dir = r'D:\_Travail\Python\Jupyter_projects'
    # 或使用正斜杠(更安全):
    # c.ServerApp.root_dir = 'D:/_Travail/Python/Jupyter_projects'

    ? 关键点:

    • 使用 c.ServerApp.root_dir(不是旧版的 c.NotebookApp.notebook_dir);
    • root_dir 是 Jupyter Server 的标准参数,明确指定根目录;
    • 若同时存在 jupyter_notebook_config.py,建议删除或注释掉其中的 notebook_dir 设置,避免冲突。
  3. 启动时无需额外参数:

    jupyter server  # 或 jupyter notebook(自动调用 server)

⚠️ 特别注意:网络驱动器(如 D: 映射盘)的常见问题

  • 权限与稳定性:确保该网络路径对当前 Windows 用户具有完全控制权限,且网络连接持续可用。Jupyter 启动时会校验目录可访问性,若网络中断或权限不足,将报错退出。
  • 路径格式建议:优先使用 UNC 路径(如 \\server\share\Jupyter_projects)替代映射盘符,可规避盘符未加载导致的启动失败。若必须用 D:,请在启动前手动打开资源管理器确认 D: 可正常访问。
  • 防坑提示:不要在配置中使用环境变量(如 %USERPROFILE%),Jupyter Server 不解析 Windows 环境变量;如需动态路径,请改用 Python 表达式(如 os.path.expanduser(r'~/Jupyter')),但需确保 import os 已在配置文件顶部声明。

总结

方法 适用场景 是否支持网络驱动器 配置复杂度
--notebook-dir 命令行参数 快速测试、多项目切换 ✅ 强烈推荐 ⭐☆☆☆☆(零配置)
c.ServerApp.root_dir 配置 固定工作流、团队标准化 ✅(需确保网络稳定) ⭐⭐☆☆☆(低)
旧版 NotebookApp.notebook_dir ❌ 已弃用,新版将忽略 ⚠️ 不推荐

执行任一有效方法后,启动 Jupyter 时左上角将显示目标路径,新建 Notebook 默认保存于此,文件浏览器也以此为根目录。建议首次使用网络路径时,先在资源管理器中手动创建测试文件夹并写入文件,验证基础读写权限无误后再配置 Jupyter。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

760

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

762

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

619

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1285

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

3

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 4.7万人学习

Django 教程
Django 教程

共28课时 | 3.2万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号