如何在Mac安裝 Jupyter Notebook

如何在Mac安裝 Jupyter Notebook

Jupyter Notebook 是很方便的Python開發工具,最大特色是允許使用者一塊一塊的開發程式。進行修改時,也不需要全部重新重跑做測試,只需要重跑改寫過的區塊即可,完美發揮Python身為interpreter的實力。Mac 也是開發者愛用的工具,曾經有報導指出使用Mac的開發者,其生產力高於使用其他電腦的開發者。如果我們在Mac上使用Jupyter Notebook,豈不美哉,以後考試都考一百分。所以今天我要來向大家介紹如何安裝Jupyter Notebook。不需要homebrew、不需要sudo、還可以安裝多個版本。本文章同時適用於所有intel與M1版的Mac系列產品。

如果懶得看完,最後我有整理懶人包,直接在terminal執行框框內的script即可。

安裝Python

這一步是不必要的,因為Mac本身就自帶Python,但避免誤會所以我們保留這一個章節。根據Mac版本的不同,可能有Python2或Python3。考慮到未來性,我們選用Python3。下方這個指令會告訴我們Python 3放在哪裡。

$ which python3
▲python3所在的位置

安裝Jupiter

Jupyter安裝方法不只一種。可以安裝在系統,也可以安裝在使用者的個人資料夾。我推薦後者,這也是我寫這篇文章的原因,稍後我向大家解釋,現在讓我們執行下面的指令。

python3 -m pip install jupyter --user

這個指令的意思是「在使用者的家目錄底下,透過python3 的pip安裝jupyter」。python3的pip通常就是pip3(但不一定,要依環境設定而定)。末端的 — user 是指安裝在使用者目錄的意思,到這裡jupyter就裝好了。但安裝的過程中,跑出這樣的一個Warning(警告)

WARNING: The scripts jupyter, jupyter-migrate and jupyter-troubleshoot are installed in '/Users/jacob975/Library/Python/3.8/bin' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

意思是「你所安裝的jupyter沒有放在預設路徑($PATH)內,而是放在/Users/jacob975/Library/Python/3.8/bin」。預設路徑的意思是可以從任意其他路徑讀取可執行檔(the executable)的路徑。舉個例子,預設路徑裡面有python3,所以我們只需要在terminal輸入python3就可以執行,不需要打上完整的/usr/bin/python3。因為預設路徑的緣故,所以執行Jupyter Notebook,要這樣做:

/Users/jacob975/Library/Python/3.8/bin/jupyter notebook

預設路徑

這樣有點麻煩,所以我們要修改一下使用者的預設路徑設定。

# For zsh user
echo export PATH="/Users/jacob975/Library/Python/3.8/bin:${PATH}" >> ~/.zshrc
source ~/.zshrc

# For bash user
echo export PATH="/Users/jacob975/Library/Python/3.8/bin:${PATH}" >> ~/.bashrc
source ~/.bashrc

這樣預設路徑就設定好了,我們先確認一下預設路徑有沒有設定成功,請執行下行程式

which jupyter
▲jupyter的安裝位置

這樣就成功了,記得使用者名字要填自己的喔!我們接下來試著執行一次Jupyter Notebook吧。

jupyter notebook

jupyter會自動開啟一個視窗,位於你剛才執行該程式的資料夾。

▲jupyter notebook首頁

點擊右方的New,選擇python3,就可以開始coding囉!

▲jupyter notebook上的python

總結

去除掉解說用的指令,統整一下安裝jupyter所需的最少指令(以zsh為例):

which python3
python3 -m pip install jupyter --user
echo export PATH="/Users/你的名字/Library/Python/3.8/bin:${PATH}" >> ~/.zshrc
source ~/.zshrc
jupyter notebook

備註

我會寫這篇網誌是因為我發現中文的有關文章的做法有兩大類。第一、使用管理員權限安裝jupyter在系統資料夾;第二、利用brew安裝jupyter。這些作法沒有不對,但是都不夠漂亮。由於Mac系統穩定度的跟系統自帶的python有關,所以不建議安裝額外的module在系統資料夾中。額外安裝新的python很安全但不方便,例如先利用brew安裝python或anaconda,再接著安裝jupyter。且這個方法同樣要設定預設路徑,也繁瑣得多。所以我認為安裝在使用者資料夾是最方便且安全的。


所有文章分類

訂閱我吧

不再錯過每一篇新文章

*

Yi-Lung Chiu