【2025.06】jupyter notebook 7+ 新手安装、配置、扩展应用（windows篇）

本文目录

前述
一、安装
二、配置
- [2.1 jupyter_notebook_config.py生成配置文件](#2.1 jupyter_notebook_config.py生成配置文件)
- [2.2 服务器与网络设置](#2.2 服务器与网络设置)
- - [a. 修改端口号](#a. 修改端口号)
  - [b. 允许远程访问](#b. 允许远程访问)
  - [c. 设置工作目录](#c. 设置工作目录)
- [2.3 安全与认证](#2.3 安全与认证)
- - [a. 禁用密码登录（仅限本地安全环境）](#a. 禁用密码登录（仅限本地安全环境）)
  - [b. 设置登录密码](#b. 设置登录密码)
  - [c. 启用SSL加密（HTTPS）](#c. 启用SSL加密（HTTPS）)
- [2.4 界面与用户体验设置](#2.4 界面与用户体验设置)
- - [a. 自定义启动页](#a. 自定义启动页)
  - [b. 禁用浏览器自动打开](#b. 禁用浏览器自动打开)
  - [c. 调整内核超时时间](#c. 调整内核超时时间)
- [2.5 扩展与插件管理](#2.5 扩展与插件管理)
- - [a、table of contents](#a、table of contents)
  - b、Debugger
  - [c、Real Time collaboration](#c、Real Time collaboration)
  - [d、Theming and Dark Mode](#d、Theming and Dark Mode)
  - e、Internationalization
  - [f、Accessibility Improvements](#f、Accessibility Improvements)
  - [g、Support for many JupyterLab extensions](#g、Support for many JupyterLab extensions)
  - [h、Compact View on Mobile Devices](#h、Compact View on Mobile Devices)

前述

本文所述jupyter notebook的安装基于anaconda，在windows操作系统之下实现，并对anaconda下的jupyter notebook特点做一些介绍，重点介绍安装和配置，具体的应用不是本章节核心内容，因为在我看来，jupyter notebook的应用，看过几分钟教程就能上手入门的，但jupyter notebook的安装和配置，如果不常操作实践，往往会让大家花费比较大的时间和精力，正所谓，"兵马未动，粮草先行" 。

本文安装在conda创建的虚拟环境(base)，anaconda安装教程可看本人同栏下相应文章。

一、安装

jupyter notebook默认情况下在anaconda安装完成后便自动给安装好了，启动方式有两种：

一是通过电脑"开始"菜单中选择jupyter notebook打开即可。

二是通过CMD命令方式打开。

一般情况下随anaconda自动安装的jupyter notebook会默认安装在conda的虚拟环境base下，并做为conda所有虚拟环境共有的功能组件形式，如果需要为某个单独的conda虚拟环境安装，需要先切换到具体的conda环境，再执行安装命令，此jupyter notebook安装仅在当前虚拟环境下生效。如下，在虚拟环境py311下安装jupyter notebook命令：

bash 复制代码

conda install jupyter notebook

安装结果：

安装完查看版本命令：jupyter notebook --version

powershell 复制代码

(py311) C:\Users\lu>jupyter notebook --version
7.3.2

(py311) C:\Users\lu>

查看所安装jupyter notebook内核信息：

bash 复制代码

jupyter kernelspec list Available kernels

如果切换到base环境下执行安装，则会覆盖或更新原来的全局jupyter notebook。

需要说明的是，在通过命令启用jupyter notebook时，会优先打开当前虚拟环境下的局部jupyter notebook,如果当前虚拟环境没有安装，则会调用全局jupyter notebook并打开。

二、配置

在 Anaconda 的 Jupyter Notebook 中，可通过修改配置文件（jupyter_notebook_config.py）或使用图形化工具调整多项核心设置，后面无特别说明，所修改或添加配置项均在jupyter_notebook_config.py文件中操作，以下是一些挑选的重点可修改配置及操作指南：

2.1 jupyter_notebook_config.py生成配置文件

执行命令：

bash 复制代码

jupyter notebook --generate-config

如果不存在jupyter_notebook_config.py，则会生成此配置文件。存在则覆盖。文件默认路径：

Linux/Mac：
~/.jupyter/jupyter_notebook_config.py
Windows：
C:\Users\<用户名>\.jupyter\jupyter_notebook_config.py

2.2 服务器与网络设置

a. 修改端口号

bash 复制代码

c.ServerApp.port = 9000  #新版配置项 默认8888

旧版相应配置项：

bash 复制代码

c.NotebookApp.port = 8889  # 旧版配置项  默认 8888

以下只罗列新版配置项，旧版一般相应配置项名前辍为c.NotebookApp.

如不修改或设置，启动时会自动采用默认端口号，如被占用则会自动选用其它空闲端口。

b. 允许远程访问

bash 复制代码

c.NotebookApp.ip = '0.0.0.0'  # 允许所有IP访问（需配合防火墙设置）
c.NotebookApp.allow_remote_access = True

c. 设置工作目录

bash 复制代码

c.ServerApp.notebook_dir = 'D:\codes_jupyter'

2.3 安全与认证

a. 禁用密码登录（仅限本地安全环境）

bash 复制代码

c.ServerApp.token = ''  # 关闭Token验证
c.ServerApp.password = ''  # 清除密码（需先生成密码）

b. 设置登录密码

jupyter notebook通常不支持直接在配置文件jupyter_notebook_config.py上添加登录访问密码设置，从 notebook 5.0 开始，可以通过命令来为 notebook 服务器输入和保存密码。jupyter notebook password会提示你输入密码，并将哈希值保存在jupyter_notebook_config.json中。此文件目录与jupyter_notebook_config.py配置所在目录相同。

命令方式

在CMD命令行下执行命令：jupyter notebook password

即可完成密码的添加，并把生成的密码存放在Jupyter_server_config.json文件中。
手动方式

准备哈希密码，使用函数notebook.auth.security.passwd()可根据你输入密码来生成对应的哈希密码。

javascript 复制代码

In [1]: from notebook.auth import passwd
In [2]: passwd()
Enter password:
Verify password:
Out[2]: 'sha1:67c9e60bb8b6:9ffede0825894254b2e042ea597d771089e11aed'

将上一步产生的哈希码可以添加到jupyter_notebook_config.py中，例如：

bash 复制代码

c.ServerApp.password = u'sha1:67c9e60bb8b6:9ffede0825894254b2e042ea597d771089e11aed'

注意： 自动化密码配置产生的哈希码存放于jupyter_notebook_config.json，手工产生的哈希码存放于jupyter_notebook_config.py。.json配置文件优先于.py配置文件，因此如果Json文件中已经配置了密码，手工配置的密码会无效。

c. 启用SSL加密（HTTPS）

在配置文件中jupyter_notebook_config.py添加本地准备好的证书文件就可以。如下：

bash 复制代码

c.ServerApp.certfile = '/path/to/your/cert.pem'
c.ServerApp.keyfile = '/path/to/your/key.pem'

2.4 界面与用户体验设置

a. 自定义启动页

默认打开的文件/目录。可在配置文件中添加如下配置项：

python 复制代码

c.ServerApp.default_url = '/tree/your_directory'  # 替换为路径

b. 禁用浏览器自动打开

可以配置文件中添加如下配置项：

python 复制代码

c.ServerApp.open_browser = False

c. 调整内核超时时间

防止长时间计算断开内核，可以配置文件中添加以下配置项：

python 复制代码

c.ServerApp.shutdown_no_activity_timeout = 86400  # 24小时（单位：秒）

旧版配置项：c.MappingKernelManager.cull_idle_timeout = 86400 # 24小时（单位：秒）

2.5 扩展与插件管理

notebook自7.0版本开始，对扩展的管理做了些明显的修改，已经不能像低版本那样通过安装jupyter_contrib_nbextensions来管理使用扩展或插件，7.0安装jupyter_contrib_nbextensions会出现不兼容的异常现象。如果是低版本（建议不超6.5版本）可以通过安装jupyter_contrib_nbextensions模块来实现扩展插件的管理，新版中已内置了扩展与插件的管理功能，通过菜单栏可便捷管理扩展和插件的应用（没有低版本中的Nbextensions标签选项）。

Jupyter Notebook v7.0.0基于JupyterLab，因此它包含了过去几年JupyterLab中添加的许多新功能和改进，下面是一些亮点功能或更新：