当前位置: 首页 > 图灵资讯 > 行业资讯> Jupyter Notebook怎么修改启动参数

Jupyter Notebook怎么修改启动参数

来源:图灵python
时间: 2026-08-24 11:27:39
启动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 都不会生效。