启动Jupyter Notebook指定目录最直接的方法是临时使用--notebook-dir参数,需要配置jupyter的永久修改__notebook_config.py文件并正确处理路径转换和快速方法的%USERPROFILE%覆盖问题。启动时临时指定目录
--notebook-dir
最直接的方法是在每次启动时添加参数而不改变任何配置。例如,希望 Notebook 打开 D:projects,执行命令行:
jupyter notebook --notebook-dir="D:projects"
注意:--notebook-dir 必须写在 jupyter notebook 后面,顺序不能逆转;路径带空间必须用双引号包裹;Windows 下反斜杠 没问题,但不要写 /(有些旧版本会分析失败);本设置仅适用于本次启动。
jupyter_notebook_config.py 文件
在生成配置文件后,它是唯一可靠的位置进行持久修改:
- 先运行
jupyter notebook --generate-config,记住输出路径,通常是C:Users用户名.jupyterjupyter_notebook_config.py - 用文本编辑器打开文件进行搜索
c.NotebookApp.notebook_dir - 取消注释(删除行首)
#),赋值为绝对路径,例如:c.NotebookApp.notebook_dir = 'D:\projects' - 路径中的反斜杠应写为双反斜杠
\或使用原始字符串r'D:projects',否则 Python 会把p当转义符报错时
%USERPROFILE% 覆盖
Windows 通过桌面或开始菜单快速启动,经常发现配置文件已更改但无效——根本原因是快速“目标”字段末尾硬编码 %USERPROFILE%,它会覆盖 c.NotebookApp.notebook_dir 设置。
解决方法:
Jupyter Notebook 7.5.4
Jupyter Notebook 7.5.4 官方 PyPI wheel 包下载适用于本地交互式代码运行、数据分析、教学演示和文件配置实践。
下载- 右键快捷方式 → “属性” → 删除“目标”栏中的末尾
%USERPROFILE% - 手动将“起始位置”改为您的目标路径,例如
D:projects - 如果“目标”中还有其他参数(如
--no-browser),确保它们写在里面jupyter-notebook-script.py以后,不要和%USERPROFILE%混在一起
--ip、--port、--no-browser 如何添加这些常用参数
多个参数可以一起使用,顺序无关,但必须放在一起 jupyter notebook 后面:
jupyter notebook --ip=0.0.0.0 --port=9999 --no-browser --notebook-dir="D:projects"
常见组合说明:
-
--ip=0.0.0.0:允许局域网其他设备访问(配合)--allow-root仅限 root 用户) -
--port=9999:避免更换端口 8888 被占用;注意防火墙是否放行 -
--no-browser:不自动弹出浏览器,适用于远程 SSH 启动或后台运行 - 所有参数名区分大小写,
--Notebook-dir或--notebook_dir都无效,只能是--notebook-dir
真正容易被忽视的是:快捷方式 %USERPROFILE% 以及配置文件中路径的转义,这两个错误已经改变了很多次 c.NotebookApp.notebook_dir 都不会生效。