拒絕似是而非：Jupyter Notebook安裝、運行和工做文件夾配置教程

拒絕似是而非：Jupyter Notebook安裝、運行和工做文件夾配置教程

---

1、Jupyter Notebook簡介

Jupyter Notebook是基於網頁的用於交互計算的應用程序。其可被應用於全過程計算：開發、文檔編寫、運行代碼和展現結果。—— Jupyter Notebook官方介紹

簡而言之，Jupyter Notebook是網頁形式的編程環境，能夠在網頁中直接編寫代碼和運行代碼，代碼的運行結果也會直接在代碼塊下顯示。如在編程過程當中須要編寫說明文檔，可在同一個頁面中直接編寫，便於及時做出說明和解釋。

2、Jupyter Notebook安裝

一、安裝方式—使用Anaconda安裝

建議經過安裝Anaconda來解決Jupyter Notebook的安裝問題，由於安裝Anaconda已經自動安裝了Jupter Notebook及其餘工具、Python解釋器以及超過180個Python科學包及其依賴項，對是否提早安裝了合適版本的Python不用關心。
進入Anaconda的官方下載頁面選擇適合版本、下載安裝文件，即可以跟安裝常規的軟件同樣安裝。本文示例，選擇了Anaconda3-2020.11-Windows-x86_64這個版本，並在Windows 10環境中安裝。

二、安裝過程當中的有關選項的選擇

雙擊下載的安裝文件，安裝便開始，基本是一路選默認選項、點擊Next，但有幾個選項須說明或做出正確選擇。

a、下面頁面上「Just me」和「All Users」兩個選項都是能夠的，不過選「All Users」須要管理員權限，若是安裝後僅本身使用的話選默認（「Just me」）就行。

b、下面頁面上的兩個複選框都須選中，以便在Windows系統中添加Anaconda的環境變量和註冊安裝的Anaconda做爲默認Python解釋器；若是不選中，在cmd、Windows PowerShell等命令行窗口沒法啓動Anaconda、Jupyter NoteBook，只能在Windows開始菜單上先啓動Anaconda，也不會註冊安裝的Anaconda做爲Python解釋器。

c、若是在安裝Anaconda前已經安裝同一版本Python解釋器，在選中上面頁面的第二個選項（註冊Anaconda做爲默認Python解釋器）後，會出現下面的提示信息，肯定即可、Anaconda便做爲默認的Python解釋器。

d、最後安裝完成，在完成頁面默認選中兩個選項，引導用戶進入Anaconda版本指導網頁和開始網頁，按默認選項或取消選中都沒影響，點擊Finish安裝便完成了。

3、Jupyter Notebook運行

Anaconda安裝完成後，能夠多種方式啓動並運行Jupyter Notebook，因爲本文不涉及Anaconda，因此不研究在Anaconda Navigator中啓動運行Jupyter Notebook，下面僅說明如下兩種方式：命令行窗口和Jupyter Notebook快捷方式。

一、命令行窗口運行Jupyter Notebook

a、打開cmd（也稱命令提示符）窗口。

b、在cmd窗口輸入以下命令並回車。

jupyter notebook

c、Jupyter Notebook即啓動。

d、Jupyter Notebook啓動後在瀏覽器中打開了Jupyter工做網頁、並在網頁中打開了默認本地工做文件夾：C:\Users\Administrator。

e、在Windows PowerShell以及Anaconda自帶的Anaconda Prompt、Anaconda Powershell Prompt等命令行窗口啓動運行Jupyter Notebook狀況基本與上述一致，只是在Anaconda中啓動Jupyter Notebook已經激活了Anaconda基本的Python環境（差別處在下圖已經標識），至於爲何要激活、怎麼激活Anaconda的Python環境，本文不予討論。

二、快捷方式運行Jupyter Notebook

在Windows 10開始菜單，依次打開Anaconda→Jupyter Notebook，即啓動運行了Jupyter Notebook，與在命令行窗口啓動運行Jupyter Notebook徹底一致。也能夠把這個快捷方式發送到桌面，點擊桌面上的Jupyter Notebook快捷方式有一樣的效果。

4、Jupyter Notebook工做文件夾配置（乾貨）

按上述方式啓動運行Jupyter Notebook後，Jupyter Notebook網頁打開的是默認的本地工做文件夾，通常爲Windows用戶文件夾，本文示例是：C:\Users\Administrator。在該文件夾中通常已經有不少子文件夾和其餘文件，不是咱們理想的工做文件夾。那麼怎麼設定咱們理想的本地工做文件夾呢？網上對這個問題的討論很是多，你們總結了N多方法，但不少方法沒有說明原理，似是而非。本文在這一章節予以詳細說明，也是寫本文的最大動機。

一、Jupyter Notebook配置文件生成

a、Jupyter Notebook安裝後，若是按默認配置運行，是不須要配置文件、啓動運行後也不會生成配置文件，要生成可修改的配置文件，須要在cmd窗口輸入如下命令並回車。

jupyter notebook --generate-config

b、該命令運行後即在Windows 用戶文件夾C:\Users\Administrator生成了子文件夾.jupyter，並在其中生成了Jupyter Notebook配置文件：jupyter_notebook_config.py，配置文件中配置設定爲默認配置。

c、若是之前生成過配置文件，則輸入上述命令後，會詢問是否覆蓋原有的配置文件，默認不覆蓋，除非你輸入y後回車即以默認配置覆蓋原有配置文件。

二、設定命令行窗口運行Jupyter Notebook的工做文件夾

即便Jupyter Notebook配置文件生成後，因爲配置文件中設定的配置爲默認設定，因此打開的本地工做文件夾認爲默認工做文件夾，通常爲Windows用戶文件夾。如何修改配置文件，以啓動理想的本地工做文件夾呢？

a、用Notepad++等文本編輯器打開已經生成的配置文件jupyter_notebook_config.py。

b、在編輯器中經過查找關鍵詞c.NotebookApp.notebook_dir來查找到配置文件中的本地工做文件夾設定語句。

c、在該語句的引號''中間輸入（爲了不差錯，最好複製）理想的本地工做文件夾的路徑。但因爲配置文件是個Python腳本文件，在Python解釋器中把\解釋爲轉義符，須要對路徑做適當修改，好比個人理想本地工做文件夾的路徑是：C:\Users\Administrator\OneDrive\WorkSpace\Jupyter，須要修改爲C:\\Users\\Administrator\\OneDrive\\WorkSpace\\Jupyter，不然解釋器在解釋該語句時會出現語法錯誤，配置不生效，以下圖；

同理，爲了能讓Python解釋器正確解釋該語句，須要把句首的#以及後面的空格（必須）所有刪除，若是（哪怕還有一個）空格不刪除，解釋器在解釋該語句時就會出現縮進錯誤，配置不生效、打開的本地工做文件夾仍然爲默認本地工做文件夾，以下圖。

• 有些網絡文章，只強調在引號間複製黏貼理想的本地工做文件夾路徑，未強調對路徑進行修改，致使讀者按文章要求作後，本地工做文件夾並未改變，令讀者一頭霧水。
• 因爲配置文件是Python腳本文件，而Python解釋器特別強調代碼縮進位置的準確性，不管語句多縮進仍是未按要求縮進，解釋器均會報縮進錯誤（IndentationError），腳本不能正常被解釋和執行，因此須要特別強調「 # 後面的空格（必須）所有刪除」，以避免少刪除空格致使縮進錯誤。

d、經試驗，把配置文件中本地工做文件夾設定語句改爲如下三種形式，效果徹底一致。

c.NotebookApp.notebook_dir = 'C:\\Users\\Administrator\\OneDrive\\WorkSpace\\Jupyter'  #  正確寫法 1

c.NotebookApp.notebook_dir = r'C:\Users\Administrator\OneDrive\WorkSpace\Jupyter'    #  正確寫法 2

c.NotebookApp.notebook_dir = 'C:/Users/Administrator/OneDrive/WorkSpace/Jupyter'    #  正確寫法 3

e、通過生成配置文件、並按上面要求修改該文件jupyter_notebook_config.py後，在命令行窗口啓動運行Jupyter Notebook，即在Jupyter工做網頁打開了理想的本地工做文件夾，本文示例爲文件夾：C:\Users\Administrator\OneDrive\WorkSpace\Jupyter，裏面尚無任何代碼文件、其餘文件和子文件夾。

三、設定快捷方式運行Jupyter Notebook的工做文件夾

按上述要求修改了配置文件後，快捷方式運行Jupyter Notebook仍是打開默認本地工做文件夾，須進一步設定。

a、打開Windows開始菜單→打開Jupyter Notebook快捷方式右鍵菜單→左鍵單擊「屬性（R）」項即打開了Jupyter Notebook快捷方式屬性對話框。

b、在Jupyter Notebook快捷方式屬性對話框的「目標(T)」項末尾刪除"%USERPROFILE%/"後肯定，Jupyter Notebook快捷方式啓動運行Jupyter Notebook即能打開理想的本地工做文件夾。

• Jupyter Notebook快捷方式屬性對話框的「目標(T)」項末尾的代碼"%USERPROFILE%/"做用是強制打開Windows用戶文件夾做爲本地工做文件夾，刪除該部分代碼後配置文件設定的本地工做文件夾生效。
• 「目標(T)」項末尾的代碼"%USERPROFILE%/"刪除後， 「起始位置(S)」項內容是什麼可有可無、配置文件都能生效；「目標(T)」項末尾的代碼"%USERPROFILE%/"不刪除， 「起始位置(S)」項內容是什麼可有可無、配置文件都不生效。
• 有些網文，試圖對上面兩項作各類花式的組合修改，都是徒勞無益的。

至此，Jupyter Notebook安裝、運行及本地工做文件夾配置完成。至於怎麼運用、在期間工做，待咱們在下一篇文章見。

Enjoy yourself.