0

0

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

花韻仙語

花韻仙語

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

|

404人浏览过

|

来源于php中文网

原创

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

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

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

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

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

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

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

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

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

    jupyter server --generate-config

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

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

    AI小聚
    AI小聚

    一站式多功能AIGC创作平台,支持AI绘画、AI视频、AI聊天、AI音乐

    下载
    c.ServerApp.root_dir = r'D:_TravailPythonJupyter_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 路径(如 \servershareJupyter_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。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1496

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1170

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

835

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

463

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2362

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

874

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

1976

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

1670

2023.08.30

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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