一、什么是Jupyter Notebook？

1. 簡(jiǎn)介

2. 組成部分

① 網(wǎng)頁(yè)應(yīng)用

② 文檔

3. Jupyter Notebook的主要特點(diǎn)

1. 編程時(shí)具有「語(yǔ)法高亮」、縮進(jìn)、tab補(bǔ)全的功能。
2. 可直接通過瀏覽器運(yùn)行代碼，同時(shí)在代碼塊下方展示運(yùn)行結(jié)果。
3. 以富媒體格式展示計(jì)算結(jié)果。富媒體格式包括：HTML，LaTeX，PNG，SVG等。
4. 對(duì)代碼編寫說明文檔或語(yǔ)句時(shí)，支持Markdown語(yǔ)法。
5. 支持使用LaTeX編寫數(shù)學(xué)性說明。

二、安裝Jupyter Notebook

0. 先試用，再?zèng)Q定

1. 安裝

① 安裝前提

② 使用Anaconda安裝

conda install jupyter notebook

③ 使用pip命令安裝

pip?install?--upgrade?pip

• 注意：老版本的pip在安裝Jupyter Notebook過程中或面臨依賴項(xiàng)無(wú)法同步安裝的問題。因此「強(qiáng)烈建議」先把pip升級(jí)到最新版本。

pip?install?jupyter

三、運(yùn)行Jupyter Notebook

0. 幫助

jupyter?notebook?--help

jupyter notebook -h

1. 啟動(dòng)

① 默認(rèn)端口啟動(dòng)

jupyter notebook

$?jupyter?notebook
[I?08:58:24.417?NotebookApp]?Serving?notebooks?from?local?directory:?/Users/catherine
[I?08:58:24.417?NotebookApp]?0?active?kernels
[I?08:58:24.417?NotebookApp]?The?Jupyter?Notebook?is?running?at:?http://localhost:8888/
[I?08:58:24.417?NotebookApp]?Use?Control-C?to?stop?this?server?and?shut?down?all?kernels?(twice?to?skip?confirmation).

• 注意：之后在Jupyter Notebook的所有操作，都請(qǐng)保持終端「不要關(guān)閉」，因?yàn)橐坏╆P(guān)閉終端，就會(huì)斷開與本地服務(wù)器的鏈接，你將無(wú)法在Jupyter Notebook中進(jìn)行其他操作啦。

② 指定端口啟動(dòng)

jupyter?notebook?--port?<port_number>

③ 啟動(dòng)服務(wù)器但不打開瀏覽器

jupyter notebook --no-browser

2. 主頁(yè)面

① 主頁(yè)面內(nèi)容

• 這個(gè)命令將會(huì)進(jìn)入你的家目錄。
• “” 是用戶名。用戶名兩邊不加尖括號(hào)“<>”。

• 這個(gè)命令將會(huì)展示你家目錄下的文件。

② 設(shè)置Jupyter Notebook文件存放位置

⑴ 創(chuàng)建文件夾/目錄

• Windows用戶在想要存放Jupyter Notebook文件的「磁盤」中「新建文件夾」并為該文件夾命名；雙擊進(jìn)入該文件夾，然后復(fù)制地址欄中的路徑。
• Linux/macOS用戶在想要存放Jupyter Notebook文件的位置「創(chuàng)建目錄」并為目錄命名，命令為：mkdir；進(jìn)入目錄，命令為：cd；查看目錄的路徑，命令為：pwd；復(fù)制該路徑。
• 注意：“”是自定義的目錄名。目錄名兩邊不加尖括號(hào)“<>”。

⑵ 配置文件路徑

• 一個(gè)便捷獲取配置文件所在路徑的命令：

jupyter notebook --generate-config

• 注意：這條命令雖然可以用于查看配置文件所在的路徑，但主要用途是是否將這個(gè)路徑下的配置文件「替換」為「默認(rèn)配置文件」。如果你是第一次查詢，那么「或許」不會(huì)出現(xiàn)下圖的提示；若文件已經(jīng)存在或被修改，使用這個(gè)命令之后會(huì)出現(xiàn)詢問“Overwrite /Users/raxxie/.jupyter/jupyter_notebook_config.py with default config? [y/N]”，即“用默認(rèn)配置文件覆蓋此路徑下的文件嗎？”，如果按“y”，則完成覆蓋，那么之前所做的修改都將失效；如果只是為了查詢路徑，那么一定要輸入“N”。

• Windows系統(tǒng)的配置文件路徑：C:\Users\\.jupyter\
• Linux/macOS系統(tǒng)的配置文件路徑：/Users//.jupyter/ 或 ~/.jupyter/
• 配置文件名：jupyter_notebook_config.py
• 注意：

⑶ 修改配置文件

• Windows系統(tǒng)的用戶可以使用文檔編輯工具或IDE打開“jupyter_notebook_config.py”文件并進(jìn)行編輯。常用的文檔編輯工具和IDE有記事本、Notepad++、vim、Sublime Text、PyCharm等。其中，vim是沒有圖形界面的，是一款學(xué)習(xí)曲線較為陡峭的編輯器，其他工具在此不做使用說明，因?yàn)樯鲜窒鄬?duì)簡(jiǎn)單。通過vim修改配置文件的方法請(qǐng)繼續(xù)往下閱讀。
• Linux/macOS系統(tǒng)的用戶建議直接通過終端調(diào)用vim來(lái)對(duì)配置文件進(jìn)行修改。具體操作步驟如下：

? 打開配置文件

vim?~/.jupyter/jupyter_notebook_config.py

? 查找關(guān)鍵詞

? 編輯配置文件

? 取消注釋

? 保存配置文件

• 「冒號(hào)（:）」 一定要有，且也是「英文半角」。
• w：保存。
• q：退出。

? 驗(yàn)證

? 注意

• 以上所有命令均以「英文半角」格式輸入，若有報(bào)錯(cuò)，請(qǐng)嚴(yán)格檢查這兩個(gè)條件，「英文」且「半角」。
• 這里僅介紹了vim編輯器修改配置文件的方法，沒有對(duì)vim編輯器的詳細(xì)使用進(jìn)行講解，所以無(wú)需了解vim編輯器的具體使用方法，只需要按照上述步驟一定可以順利完成修改！
• 推薦有時(shí)間和經(jīng)歷時(shí)學(xué)習(xí)一下vim編輯器的使用。這款強(qiáng)大的編輯器將會(huì)成為你未來(lái)工作中的利器。

四、Jupyter Notebook的基本使用

1. Files頁(yè)面

① 筆記本的基本操作

② 筆記本重命名的兩種方式

⑴ ?筆記本內(nèi)部重命名

⑵ ?筆記本外部重命名

⑶ 演示

2. Running頁(yè)面

3. Clusters頁(yè)面

4. Conda頁(yè)面

5. Nbextensions頁(yè)面

五、拓展功能

1. 關(guān)聯(lián)Jupyter Notebook和conda的環(huán)境和包——“nb_conda”☆

① 安裝

conda install nb_conda

② 使用

• 可以在Conda類目下對(duì)conda環(huán)境和包進(jìn)行一系列操作。

  

• 可以在筆記本內(nèi)的“Kernel”類目里的“Change kernel”切換內(nèi)核。

  

③ 卸載

canda?remove?nb_conda

2. Markdown生成目錄

• 不同于有道云筆記的Markdown編譯器，Jupyter Notebook無(wú)法為Markdown文檔通過特定語(yǔ)法添加目錄，因此需要通過安裝擴(kuò)展來(lái)實(shí)現(xiàn)目錄的添加。

conda?install?-c?conda-forge?jupyter_contrib_nbextensions

• 執(zhí)行上述命令后，啟動(dòng)Jupyter Notebook，你會(huì)發(fā)現(xiàn)導(dǎo)航欄多了“Nbextensions”的類目，點(diǎn)擊“Nbextensions”，勾選“Table of Contents ⑵”

  

• 之后再在Jupyter Notebook中使用Markdown，點(diǎn)擊下圖的圖標(biāo)即可使用啦。

  

3. Markdown在文中設(shè)置鏈接并定位

[添加鏈接的正文](#自定義索引詞)
<a?id=自定義索引詞>跳轉(zhuǎn)提示a>

• 注意：

1. 語(yǔ)法格式當(dāng)中所有的符號(hào)均是「英文半角」。
2. “自定義索引詞”最好是英文，較長(zhǎng)的詞可以用下劃線連接。
3. “a標(biāo)簽”出現(xiàn)在想要被跳轉(zhuǎn)到的文章位置，html標(biāo)簽除了單標(biāo)簽外均要符合“有頭（）必有尾（）”的原則。頭尾之間的“跳轉(zhuǎn)提示”是可有可無(wú)的。
4. “a標(biāo)簽”中的“id”值即是為正文中添加鏈接時(shí)設(shè)定的“自定義索引值”，這里通過“id”的值實(shí)現(xiàn)從正文的鏈接跳轉(zhuǎn)至指定位置的功能。

• 例：

1.有跳轉(zhuǎn)提示語(yǔ)

2.無(wú)跳轉(zhuǎn)提示語(yǔ)

4. 加載指定網(wǎng)頁(yè)源代碼

① 使用場(chǎng)景

② 方法

%load URL

③ 例

5. 加載本地Python文件

① 使用場(chǎng)景

② 方法

%load Python文件的絕對(duì)路徑

③ 注意

1. Python文件的后綴為“.py”。
2. “%load”后跟的是Python文件的「絕對(duì)路徑」。
3. 輸入命令后，可以按CTRL 回車來(lái)執(zhí)行命令。第一次執(zhí)行，是將本地的Python文件內(nèi)容加載到單元格內(nèi)。此時(shí)，Jupyter Notebook會(huì)自動(dòng)將“%load”命令注釋掉（即在前邊加井號(hào)“#”），以便在執(zhí)行已加載的文件代碼時(shí)不重復(fù)執(zhí)行該命令；第二次執(zhí)行，則是執(zhí)行已加載文件的代碼。

④ 例

6. 直接運(yùn)行本地Python文件

① 使用場(chǎng)景

② 方法

%run Python文件的絕對(duì)路徑

!python3 Python文件的絕對(duì)路徑

!python Python文件的絕對(duì)路徑

③ 注意

1. Python文件的后綴為“.py”。
2. “%run”后跟的是Python文件的「絕對(duì)路徑」。
3. “!python3”用于執(zhí)行Python 3.x版本的代碼。
4. “!python”用于執(zhí)行Python 2.x版本的代碼。
5. “!python3”和“!python”屬于 !shell命令 語(yǔ)法的使用，即在Jupyter Notebook中執(zhí)行shell命令的語(yǔ)法。
6. 輸入命令后，可以按 CTRL 回車 來(lái)執(zhí)行命令，執(zhí)行過程中將不顯示本地Python文件的內(nèi)容，直接顯示運(yùn)行結(jié)果。

④ 例

7. 在Jupyter Notebook中獲取當(dāng)前位置

① 使用場(chǎng)景

② 方法

%pwd

!pwd

③ 注意

1. 獲取的位置是當(dāng)前Jupyter Notebook中創(chuàng)建的筆記本所在位置，且該位置為「絕對(duì)路徑」。
2. “!pwd”屬于 !shell命令 語(yǔ)法的使用，即在Jupyter Notebook中執(zhí)行shell命令的語(yǔ)法。

④ 例

8. 在Jupyter Notebook使用shell命令

① 方法一——在筆記本的單元格中

⑴ 語(yǔ)法

!shell命令

• 在Jupyter Notebook中的筆記本單元格中用英文感嘆號(hào)“!”后接shell命令即可執(zhí)行shell命令。

⑵ 例

② 方法二——在Jupyter Notebook中新建終端

⑴ 啟動(dòng)方法

⑵ 關(guān)閉方法

⑶ 例

9. 隱藏筆記本輸入單元格

① 使用場(chǎng)景

② 方法一

⑴ 代碼

from?IPython.display?import?display
from?IPython.display?import?HTML
import?IPython.core.display?as?di?#?Example:?di.display_html('
%s:
'?%?str,?raw=True)

#?這行代碼的作用是：當(dāng)文檔作為HTML格式輸出時(shí)，將會(huì)默認(rèn)隱藏輸入單元格。
di.display_html('',?raw=True)

#?這行代碼將會(huì)添加“Toggle code”按鈕來(lái)切換“隱藏/顯示”輸入單元格。
di.display_html('''Toggle?code''',?raw=True)

• 缺陷：此方法不能很好的適用于Markdown單元格。

⑵ 例

③ 方法二

⑴ 代碼

from?IPython.display?import?HTML

HTML('''<script>
code_show=true;?
function?code_toggle()?{
?if?(code_show){
?$('div.input').hide();
?}?else?{
?$('div.input').show();
?}
?code_show?=?!code_show
}?
$(?document?).ready(code_toggle);
script>
<form?action="javascript:code_toggle()"><input?type="submit"?value="Click?here?to?toggle?on/off?the?raw?code.">form>''')

• 缺陷：此方法不能很好的適用于Markdown單元格。

⑵ 例

10. 魔術(shù)命令

六、增加內(nèi)核——“ipykernel” ☆

1. 使用場(chǎng)景

1. 場(chǎng)景一：同時(shí)用不同版本的Python進(jìn)行工作，在Jupyter Notebook中無(wú)法切換，即“New”的下拉菜單中無(wú)法使用需要的環(huán)境。
2. 場(chǎng)景二：創(chuàng)建了不同的虛擬環(huán)境（或許具有相同的Python版本但安裝的包不同），在Jupyter Notebook中無(wú)法切換，即“New”的下拉菜單中無(wú)法使用需要的環(huán)境。

2. 解決方法之命令行模式

① 同時(shí)使用不同版本的Python

⑴ 在Python 3中創(chuàng)建Python 2內(nèi)核

? pip安裝

• 首先安裝Python 2的ipykernel包。

python2 -m pip install ipykernel

• 再為「當(dāng)前用戶」安裝Python 2的內(nèi)核（ipykernel）。

python2 -m ipykernel install --user

• 注意：“--user”參數(shù)的意思是針對(duì)當(dāng)前用戶安裝，而非系統(tǒng)范圍內(nèi)安裝。

? conda安裝

• 首先創(chuàng)建Python版本為2.x且具有ipykernel的新環(huán)境，其中“”為自定義環(huán)境名，環(huán)境名兩邊不加尖括號(hào)“<>”。

conda?create?-n?<env_name>?python=2?ipykernel

• 然后切換至新創(chuàng)建的環(huán)境。

Windows:?activate?<env_name>
Linux/macOS:?source?activate?<env_name>

• 為「當(dāng)前用戶」安裝Python 2的內(nèi)核（ipykernel）。

python2 -m ipykernel install --user

• 注意：“--user”參數(shù)的意思是針對(duì)當(dāng)前用戶安裝，而非系統(tǒng)范圍內(nèi)安裝。

⑵ 在Python 2中創(chuàng)建Python 3內(nèi)核

? pip安裝

• 首先安裝Python 3的ipykernel包。

python3 -m pip install ipykernel

• 再為「當(dāng)前用戶」安裝Python 2的內(nèi)核（ipykernel）。

python3 -m ipykernel install --user

• 注意：“--user”參數(shù)的意思是針對(duì)當(dāng)前用戶安裝，而非系統(tǒng)范圍內(nèi)安裝。

? conda安裝

• 首先創(chuàng)建Python版本為3.x且具有ipykernel的新環(huán)境，其中“”為自定義環(huán)境名，環(huán)境名兩邊不加尖括號(hào)“<>”。

conda?create?-n?<env_name>?python=3?ipykernel

• 然后切換至新創(chuàng)建的環(huán)境。

Windows:?activate?<env_name>
Linux/macOS:?source?activate?<env_name>

• 為「當(dāng)前用戶」安裝Python 3的內(nèi)核（ipykernel）。

python3 -m ipykernel install --user

• 注意：“--user”參數(shù)的意思是針對(duì)當(dāng)前用戶安裝，而非系統(tǒng)范圍內(nèi)安裝。

② 為不同環(huán)境創(chuàng)建內(nèi)核

⑴ 切換至需安裝內(nèi)核的環(huán)境

Windows:?activate?<env_name>
Linux/macOS:?source?activate?<env_name>

• 注意：“”是需要安裝內(nèi)核的環(huán)境名稱，環(huán)境名兩邊不加尖括號(hào)“<>”。

⑵ 檢查該環(huán)境是否安裝了ipykernel包

conda?list

conda install ipykernel

⑶ 為當(dāng)前環(huán)境下的當(dāng)前用戶安裝Python內(nèi)核

• 若該環(huán)境的Python版本為2.x，則執(zhí)行命令：

python2?-m?ipykernel?install?--user?--name?<env_name>?--display-name?"<notebook_name>"

• 若該環(huán)境的Python版本為3.x，則執(zhí)行命令：

python3?-m?ipykernel?install?--user?--name?<env_name>?--display-name?"<notebook_name>"

• 注意:
1. “”為當(dāng)前環(huán)境的環(huán)境名稱。環(huán)境名兩邊不加尖括號(hào)“<>”。
2. “”為自定義顯示在Jupyter Notebook中的名稱。名稱兩邊不加尖括號(hào)“<>”，但「雙引號(hào)必須加」。
3. “--name”參數(shù)的值，即“”是Jupyter內(nèi)部使用的，其目錄的存放路徑為~/Library/Jupyter/kernels/。如果定義的名稱在該路徑已經(jīng)存在，那么將自動(dòng)覆蓋該名稱目錄的內(nèi)容。
4. “--display-name”參數(shù)的值是顯示在Jupyter Notebook的菜單中的名稱。

⑷ 檢驗(yàn)

3. 解決方法之圖形界面模式

七、Jupyter Notebook快捷鍵

1. Mac與Windows特殊按鍵對(duì)照表

2. Jupyter Notebook筆記本的兩種模式

① 命令模式

• 命令模式將鍵盤命令與Jupyter Notebook筆記本命令相結(jié)合，可以通過鍵盤不同鍵的組合運(yùn)行筆記本的命令。
• 按esc鍵進(jìn)入命令模式。
• 命令模式下，單元格邊框?yàn)榛疑易髠?cè)邊框線為藍(lán)色粗線條。

② 編輯模式

• 編輯模式使用戶可以在單元格內(nèi)編輯代碼或文檔。
• 按enter或return鍵進(jìn)入編輯模式。
• 編輯模式下，單元格邊框和左側(cè)邊框線均為綠色。

3. 兩種模式的快捷鍵

① 命令模式

② 編輯模式

4. 查看和編輯快捷鍵

① 查看快捷鍵

② 編輯快捷鍵

⑴ 方法一

⑵ 方法二

③ 例

八、關(guān)閉和退出

1. 關(guān)閉筆記本和終端

① 方法一

• 注意：此方法只能關(guān)閉筆記本，無(wú)法關(guān)閉終端。

② 方法二

• 注意：此方法可以關(guān)閉任何正在運(yùn)行的終端和筆記本。

③ 注意

④ 演示

2. 退出Jupyter Notebook程序

• Mac用戶：control c
• Windows用戶：ctrl c