Jupyter Notebook常用配置命令

本文由Jupyter Notebook介绍、安装及使用教程-简书以及给初学者的 Jupyter Notebook 教程-知乎整理得到。

1 安装

1.1 使用Anaconda安装

conda install jupyter notebook

1.2 使用pip命令安装

对于Python 3.x

pip3 install jupyter

对于Python 2.x

pip install jupyter

2 运行Jupyter Notebook

2.1 启动

（1）默认端口启动

jupyter notebook

（2）指定端口启动

jupyter notebook --port <port_number>

示例：jupyter notebook --port 9999，即在端口号为“9999”的服务器启动Jupyter Notebook。

（3）启动服务器但不打开浏览器

jupyter notebook --no-browser

此时，将会在终端显示启动的服务器信息，并在服务器启动之后，显示出打开浏览器页面的链接。当你需要启动浏览器页面时，只需要复制链接，并粘贴在浏览器的地址栏中，轻按回车变转到了你的Jupyter Notebook页面。

2.2 设置Jupyter Notebook文件存放位置

（1）获取配置文件路径

jupyter notebook --generate-config

• 注意： 这条命令虽然可以用于查看配置文件所在的路径，但主要用途是是否将这个路径下的配置文件替换为默认配置文件。
  如果你是第一次查询，那么或许不会出现提示；若文件已经存在或被修改，使用这个命令之后会出现询问“Overwrite /Users/raxxie/.jupyter/jupyter_notebook_config.py with default config? [y/N]”，即“用默认配置文件覆盖此路径下的文件吗？”，如果按“y”，则完成覆盖，那么之前所做的修改都将失效；如果只是为了查询路径，那么一定要输入“N”。
• 常规情况下，Windows和Linux/macOS的配置文件所在路径和配置文件名如下所述：
  – Windows系统的配置文件路径：C:\Users\<user_name>\.jupyter\
  – Linux/macOS系统的配置文件路径：/Users/<user_name>/.jupyter/ 或 ~/.jupyter/
  – 配置文件名：jupyter_notebook_config.py

（2）修改配置文件

• 使用文档编辑工具或IDE打开“jupyter_notebook_config.py”文件；
• 查找关键词“c.NotebookApp.notebook_dir”；
• 把该行行首的井号（#）删除。因为配置文件是Python的可执行文件，在Python中，井号（#）表示注释，即在编译过程中不会执行该行命令，所以为了使修改生效，需要删除井号（#）。然后更改路径保存即可。
  

3 拓展功能

3.1 关联Jupyter Notebook和conda的环境和包

（1）安装

conda install nb_conda

执行上述命令能够将你conda创建的环境与Jupyter Notebook相关联，便于你在Jupyter Notebook的使用中，在不同的环境下创建笔记本进行工作。
（2）使用

• 可以在 Conda类目下对conda环境和包进行一系列操作。
  
• 可以在笔记本内的“Kernel”类目里的“Change kernel”切换内核。
  
  （3）卸载

conda remove nb_conda

执行上述命令即可卸载nb_conda包。

3.2 Mardown生成目录

不同于有道云笔记的Markdown编译器，Jupyter Notebook无法为Markdown文档通过特定语法添加目录，因此需要通过安装扩展来实现目录的添加。

conda install -c conda-forge jupyter_contrib_nbextensions

执行上述命令后，启动Jupyter Notebook，你会发现导航栏多了“Nbextensions”的类目，点击“Nbextensions”，勾选“Table of Contents ⑵”

之后再在Jupyter Notebook中使用Markdown，点击下图的图标即可使用啦。

4 Jupyter Notebook快捷键

4.1 Mac与Windows特殊按键对照表

符号	Mac按键	Windows按键
⌘	command	无
^	control	ctrl
⌥	option	alt
⇧	shift	shift
↩	return	return
␣	space	space
⇥	tab	tab
⌫	delete	backspace
⌦	fn delete	delete
-	-	-

4.2 Jupyter Notebook笔记本的两种模式

（1）命令模式

• 命令模式将键盘命令与Jupyter Notebook笔记本命令相结合，可以通过键盘不同键的组合运行笔记本的命令。
• 按esc键进入命令模式。
• 命令模式下，单元格边框为灰色，且左侧边框线为蓝色粗线条。

（2）编辑模式

• 编辑模式使用户可以在单元格内编辑代码或文档。
• 按enter或return键进入编辑模式。
• 编辑模式下，单元格边框和左侧边框线均为绿色。
  

4.3 两种模式的快捷键

（1）命令模式

快捷键	用途
F	查找和替换
↩	进入编辑模式
⌘⇧F	打开命令选项板
⌘⇧P	打开命令选项板
P	打开命令选项板
⇧↩	运行当前单元格并选中下一个单元格
⌃↩	运行选中单元格
⌥↩	运行当前单元格并且在下方插入单元格
Y	将单元格切换至code状态
M	将单元格切换至markdown状态
R	将单元格切换至raw状态
1	将单元格设定一级标题
2	将单元格设定二级标题
3	将单元格设定三级标题
4	将单元格设定四级标题
5	将单元格设定五级标题
6	将单元格设定六级标题
↑	选中上方单元格
K	选中上方单元格
↓	选中下方单元格
J	选中下方单元格
⇧K	向上多选单元格
⇧↑	向上多选单元格
⇧J	向下多选单元格
⇧↓	向下多选单元格
A	在上方插入单元格
B	在下方插入单元格
X	剪切选中单元格
C	复制选中单元格
⇧V	粘贴到上方单元格
V	粘贴到下方单元格
Z	撤销删除
D, D	删除选中单元格
⇧M	合并选中单元格，若直选中一个则与下一个单元格合并
⌘S	保存
S	保存
L	转换行号
O	转换输出
⇧O	转换滚动输出
H	显示快捷键帮助
I, I	中断Notebook内核
O, O	重启Notebook内核
esc	关闭页面
Q	关闭页面
⇧L	转换所有单元格行号且设置持续有效
⇧␣	向上滚动
␣	向下滚动

（2）编辑模式

Mac快捷键	Windows快捷键	用途
⇥	⇥	代码补全或缩进
⇧⇥	⇧⇥	提示
⌘]	⌃]	向后缩进
⌘[	⌃[	向前缩进
⌘A	⌃A	全选
⌘Z	⌃Z	撤销
⌘/		注释
⌘D		删除该行内容
⌘U		撤销
⌘↑	⌃↑	光标跳转至单元格起始位置
⌘↓	⌃↓	光标跳转至单元格最终位置
⌥←	⌃←	光标位置左移一个单词
⌥→	⌃→	光标位置右移一个单词
⌥⌫	⌃⌫	删除前边一个单词
⌥⌦	⌃⌦	删除后边一个单词
⌘⇧Z	⌃Y	重做
⌘⇧U	⌃⇧Z	重做
⌘⌫	⌃⌫	删除该行光标左边内容
⌘⌦	⌃⌦	删除该行光标右边内容
⌃M	⌃M	进入命令模式
esc	esc	进入命令模式
⌘⇧F		打开命令选项板
⌘⇧P		打开命令选项板
⇧↩	⇧↩	运行当前单元格并选中下一个单元格
⌃↩	⌃↩	运行选中单元格
⌥↩	⌥↩	运行当前单元格并且在下方插入单元格
⌃⇧-	⌃⇧-	以光标所在位置分割单元格
⌘S	⌃S	保存
↓	↓	下移光标
↑	↑	上移光标

4.4 查看和编辑快捷键

（1）查看快捷键

• 进入Jupyter Notebook主界面“File”中。
• 在“New”的下拉列表中选择环境创建一个笔记本。
• 点击“Help”。
• 点击“Keyboard Shortcuts”。

（2）编辑快捷键

• 进入Jupyter Notebook主界面“File”中。
• 在“New”的下拉列表中选择环境创建一个笔记本。
• 点击“Help”。
• 点击“Edit Keyboard Shortcuts”。

5 分享Notebook笔记

5.1 分享之前

当导出或保存笔记时，共享的 notebook 将会以被导出或保存的那一刻的状态显示，包括所有代码单元的输出。因此，为了确保notebook 正确共享的，在分享之前可以采取以下步骤：

• 点击 “Cell > All Output > Clear”
• 点击 “Kernel > Restart & Run All”
• 等待代码单元完成执行，并检查它们是否按预期执行。

这将确保 notebook 不包含中间输出，不包含陈旧的状态，并在共享时按顺序执行。

5.2 导出Notebook

Jupyter 内置支持导出 HTML 和 PDF 以及其他几种格式，你可以在 File > Download As 菜单下找到。如果你希望与一个小型的私有组共享你的 notebook，这个功能很可能是你所需要的。事实上，许多学术机构的研究人员都有一些公共或内部的网络空间，因为你可以将一个 notebook 导出到一个 HTML 文件中，Jupyter notebook 可以成为他们与同行分享成果的一种特别方便的方式。

但是，如果共享导出的文件并不能让你满意，那么还有一些更直接的非常流行的共享 .ipynb 文件到网上的方法。

5.3 GitHub与Gist服务

截止到 2018 年初，GitHub 上的公共 notebook 数量超过了 180 万，它无疑是最受欢迎的与世界分享 Jupyter 项目的独立平台。GitHub 已经集成了对 .ipynb 的文件渲染的支持，你可以直接将其存储在其网站的仓库和 gists 中。如果你还不知道，GitHub 是一个代码托管平台，用于为使用 Git 创建的存储库进行版本控制和协作。你需要创建一个帐户来使用他们的服务，同时 Github 标准帐户是免费的。

当你有了 GitHub 账户，在 GitHub 上共享一个 notebook 最简单的方法甚至都不需要 Git。自 2008 年以来， GitHub 为托管和共享代码片段提供了Gist 服务，每个代码段都有自己的存储库。使用 Gists 共享一个 notebook：

• 登录 gist.github.com。
• 用文件编辑器打开 .ipynb 文件, 全选并且拷贝里面的 JSON 。
• 将笔记的 JSON 粘贴到中 gist 中。
• 给你的 Gist 命名, 记得添加 .iypnb 后缀，否则不能正常工作。
• 点击 "Create secret gist"或者 “Create public gist.”

这看起来应该是这样的：

如果你创建了一个公共的 Gist，你现在就可以和任何人分享它的 URL，其他人将能够 fork 和 clone 你的工作。

创建自己的 Git 存储库并在 GitHub 上共享，这超出了本教程的范围，但是 GitHub 提供了大量的指南可供你参考。

对于那些使用 git 的人来说，一个额外的技巧是在 .gitignore 中为 Jupyter 创建的 .ipynb_checkpoints 目录添加例外，因为我们不需要将检查点文件提交给到仓库。

从 2015 年起，NBViewer 每个星期都会渲染成千上万的 notebook，它已然成了最受欢迎的 notebook 渲染器。如果你已经在某个地方把你的 Jupyter Notebook 放在网上，无论是 GitHub 还是其他地方，NBViewer 都可以读取你的 notebook，并提供一个可共享的 URL。作为项目 Jupyter 的一部分提供的免费服务，你可以在 nbview.jupyter.org 找到相关服务。

最初是在 GitHub 的 Jupyter Notebook 集成之前开发的，NBViewer 允许任何人输入 URL、Gist ID 或 GitHub username/repo/filename，并将其作为网页呈现。一个 Gist 的 ID 是其 URL 末尾唯一的数字；例如，在 https://gist.github.com/username/50896401c23e0bf417e89e1de 中最后一个反斜杠后的字符串。如果你输入了 GitHub username/repo/filename ，你将看到一个最小的文件浏览器，它允许你访问用户的仓库及其内容。

NBViewer 显示的 notebook 的 URL 是基于正在渲染的 notebook 的 URL 的并且不会改变，所以你可以和任何人分享它，只要原始文件保持在线 —— NBViewer 不会缓存文件很长时间。

6 结语

从基础知识入手，我们已经掌握了 Jupyter Notebook 的工作流程，深入研究了IPython 的更多高级功能，并最终学会如何与朋友、同事和世界分享我们的工作。我们从一个笔记上完成了这一切!

可以看到，notebook 是如何通过减少上下文切换和在项目中模拟自然的思维发展的方式来提高工作经验的。Jupyter Notebook。Jupyter Notebook 的功能也应该是显而易见的，我们已经介绍了大量的资源，让你开始在自己的项目中探索更高级的特性。

如果你想为自己的 Notebooks 提供更多的灵感，Jupyter 已经整理好了(一个有趣的 Jupyter Notebook 图库)，你可能会发现它有帮助，并且你会发现 Nbviewer 的主页链接到一些真正的高质量笔记本的例子。也可以查看我们的 Jupyter Notebooks 提示列表。