Jupyter下载安装及小白使用手册（入门向）

Jupyter使用手册

 

厦门大学 WISERCLUB

2024.10

1. Jupyter介绍

Jupyter可以理解为python笔记本，可以分块运行python代码并展示输出结果，支持markdown格式的文本显示。

简单来说，jupyter中有三部分内容：markdown格式的文本块; python代码块; python的输出结果块。

Jupyter文件的后缀为.ipynb。

Vscode或Pycharm中可以直接新建Jupyter文件。

#这是代码块
a = 'hello world'


print('这是代码块的输出结果')
print(a)

这是代码块的输出结果
hello world

2.如何安装Jupyter

使用Anaconda安装（推荐）

1. 确认Anaconda安装。首先确保已经在计算机中安装了Anaconda；使用Win+R打开cmd命令符，输入conda --version查看当前系统中Anaconda的版本，有版本号即为已经成功安装。Anaconda在安装的同时，其实已经自动在电脑上安装了jupyter notebook。
   

2. 进入Anaconda Navigator页面。Anaconda Navigator可以理解为Anaconda的应用导航页面。用户可以在这个页面管理自己的应用、环境和包。这其中就有jupyter notebook这个应用（application）。有三种方式打开Anaconda Navigator页面：

   （1）“开始”菜单栏直接搜索Anaconda Navigator，点击打开。（简洁、常用）

（2）在Anaconda的安装路径文件夹中找到对应的应用程序Anaconda Navigator，点击打开。这里每个人的安装路径不同，根据安装时候选择的位置决定。

（3）使用Anaconda Prompt打开Anaconda Navigator。Anaconda Prompt可以理解为“Anaconda专用的cmd”，使用命令行代码管理Anaconda。在Anaconda Prompt中输入anaconda-navigator。

• 打开后出现如下页面即为成功：

3. 打开jupyter notebook。在Anaconda Navigator中，找到jupyter notebook，点击"Launch"即可。

4. 安装完成！看到如下页面即为成功安装！

使用pip安装

1. 确认python安装。首先确保已经在计算机中安装了python；使用Win+R打开cmd命令符，输入python --version查看当前系统中python的版本，有版本号即为已经成功安装。

2. 安装jupyter notebook。接下来使用系统命令符安装jupyter notebook；使用Win+R打开cmd命令符，输入pip install jupyter notebook，进行安装

3. 打开jupyter notebook。最后，完成安装后可以直接使用系统命令符打开jupyter notebook；输入jupyter notebook。请注意，这时就不要关闭这个cmd窗口了，否则jupyter notebook也会关闭。（Jupyter 实际上将你的电脑作为一台本地服务器来运行，其主页会在浏览器中打开。默认情况下，Notebook 服务器的访问地址是 http://localhost:8888。 其中，localhost 代表你的计算机本身，而 8888 则是服务器用于通信的端口。）

4. 安装完成！看到如下页面即为成功安装！

3. Jupyter的使用-小白入门手册

打开/创建新的Jupyter notebook文件

1. 打开jupyter notebook后，进入主页面（home），该页面显示了Jupyter notebook默认工作目录下的所有文件，你可以直接打开.ipynb尾缀的文件，或者新建一个文件（选择Python3 ipykernel，稍后解释）

2. 以创建新的文件为例，创建成功后显示如下页面

选择/更改内核

1. 什么是内核？在 Jupyter 中，内核（Kernel）是一个独立的计算引擎（可以理解为当前文件正在使用的编程语言）。每个 Jupyter Notebook 都与一个特定的内核关联。支持Python、R、Java等等。

2. 在创建notebook文件时选择内核。如下图所示，准备创建一个以python为内核的notebook文件。

3. 更改内核。对于已经创建并打开的notebook文件，可以直接在上边栏“kernel”处修改其内核。

创建/修改单元格（cell）的类型

1. 创建一个单元格。点击上方栏加号创建一个单元格，默认为代码单元格。
   

2. 修改单元格类型。选中单元格，点击上方栏切换单元格类型。主要有以下三种类型（标题类型最新版本暂不可用）：

   （1） 代码；使用python语法（当然，切换不同内核对应着不同编程语言）。可以运行

   （2） markdown；使用markdown语法。可以运行

   （3） 原生 NBConvert（Raw NBConvert）；写在Raw NBConvert中的代码不会被渲染运行，文档输出的时候能够保留原始代码或执行某些格式化操作。（很少很少用到）

关于单元格的各类操作

1. 编辑模式（edit）与命令模式（command）。点击单元格内部，最左边显示绿色，此时为编辑模式，正常编写代码即可。点击单元格左侧，最左边显示蓝色，此时为编辑模式，可以对单元格进行一系列其他操作。
   
   

2. 常见快捷命令。

   （1） A；插入上方单元格；在当前单元格上方插入一个新的单元格。

   （2） B；插入下方单元格；在当前单元格下方插入一个新的单元格。

   （3） D, D；删除单元格；删除当前选中的单元格。

   （4） Y；切换到代码单元格；将当前单元格类型切换为代码单元格。

   （5） M；切换到Markdown单元格；将当前单元格类型切换为Markdown单元格。

   （6） Z；撤销删除单元格；撤销上一次删除单元格的操作。

   （7） Ctrl + S；保存文件；保存当前的Notebook文件。

   （8） Shift + Enter；运行单元格并选中下一个；运行当前单元格并选中下一个单元格。

   （9） Shift + Ctrl + Enter；运行上方所有单元格；运行当前单元格及其上方的所有单元格。

   （10） Ctrl + Up；上移单元格；将当前单元格上移一个位置。

   （11） Ctrl + Down；下移单元格；将当前单元格下移一个位置。

3. 查看所有快捷命令。点击上方栏“小键盘”，即可查看所有命令。


4. 代码块运行规则。由于Jupyter notebook中的代码是分块运行的，所以代码运行的先后顺序很重要。

   （1） 代码单元格前面的In []表示了该代码块是第几个运行的，

   • In：代表这是一个输入单元格，用户在这里输入代码。

   • []：方括号中通常会显示一个数字，表示该单元格的执行顺序。例如，In[1] 表示这是第一个被执行的输入单元格。

   • 空的方括号 []：如果方括号中是空的，表示该单元格还没有被执行过。

   （2） 运行过的代码块，其创建的变量、函数、输出结果会被保存，后面运行的代码块可以直接调用。如果想彻底重新运行所有代码，可以重启内核（上方栏有重启选项）。

   （3） 代码块的输出结果，会跟随文件一起保存，即使重启内核或重新打开文件，上次的输出结果仍然保留，直到重新运行这部分代码块。

以上就是关于Jupyter notebook的基本操作，开启你的编程和分享之旅吧~

扩展1：jupyter-lab的使用

jupyter lab：进化版jupyter notebook

jupyter notebook的页面较为简洁，只能同时编写一个文件。而jupter lab的功能更为全面，可以进行文档管理、编辑多个多类型文件、实时查看变量、可视化输出、增加插件等功能。是一个集成的开发环境。可以理解为 属于jupyter 的jupytercharm。

安装Anaconda后，可以直接使用Anaconda Navigator打开jupyter lab。

打开后界面如下：

关于jupter lab的详细介绍可以参考 JupyterLab最全详解，如果你还在使用Notebook，那你就out了！https://zhuanlan.zhihu.com/p/154515490



关于jupter lab的实用插件可以参考 熬了半宿！梳理了 JupyterLab 上 20 个超级实用的扩展！https://zhuanlan.zhihu.com/p/339798297

扩展2：如何使用vscode编写jupyter

除了使用电脑作为服务器运行jupyter，还可以直接使用vscode打开.ipynb文件并编辑。

安装jupyter扩展

（1）确保已经下载python，jupyter。并在vscode中安装了python的扩展。

（2）在vscode的“扩展”中搜索jupyter。直接安装即可。

（3）安装后即可创建新的jupyter文件：

`Ctrl + Win + Alt + N`创建新的文件，选择jupyter文件。

（4）点击右上角选择内核，选择python内核即可。

（5）之后就可以顺利地使用vscode编写jupyter文档啦