Mac 設定 Python 開發環境：2026 新手從安裝到執行

Python 官方文件記載，venv 自 Python 3.3 起納入標準程式庫，讓專案可以使用彼此隔離的套件環境（Python venv 文件）。因此，Mac 設定 Python 開發環境時，建議先核對課程指定版本，再選官方安裝器或 Homebrew，最後為每個專案建立獨立環境；沒有 Mac，也不必為了學 Python 先買一台。

適合閱讀對象
第一次在 Mac 上學 Python，想按步驟完成安裝和首次執行的學生。
已經裝過 Python，卻不確定課程專案要用哪個版本的初學者。
手邊沒有 Mac，但課程要求 macOS，想先判斷遠端練習是否合用的學習者。

動手前先核對課程要求

先找出課程指定的 Python 版本、編輯器，以及有沒有 requirements.txt 之類的套件清單。這些資訊通常在作業說明、教師提供的安裝文件或專案資料夾裡。若課程明確要求特定版本，安裝前先記下來，不要因為看到更新的版本就直接選它。

可以把 Python 想成課堂指定的教材版本：教材相同，課程範例才比較容易照著做。若本機原本已有 Python，也不要假設終端機一定會使用它；電腦裡可能有不只一個安裝位置，命令最後找到哪一個，才是實際執行的版本。

先做這份簡短檢查：

• [ ] 找到課程要求的 Python 版本，並確認是否允許使用其他版本。
• [ ] 記下課程推薦的編輯器與安裝方式；沒有指定時再自行選擇。
• [ ] 查看專案中是否有 requirements.txt 或其他相依套件清單。
• [ ] 確認作業需不需要 macOS 專屬軟體、圖形介面或本機檔案。

這些項目會決定後續該下載哪個版本、是否需要安裝套件，以及用本機還是遠端環境練習。

依照課程版本選擇安裝方式

Python macOS 安裝可從官方安裝器或 Homebrew 開始，沒有一種選擇適合所有初學者。若課程指定安裝方式，先遵照課程文件；沒有指定時，再按自己是否已使用 Homebrew，以及是否需要特定版本來判斷。

官方安裝器適合希望按下載頁指示操作，或課程要求使用官方提供版本的初學者。先到 Python 官方 macOS 下載頁查看目前提供的安裝檔和適用說明；安裝前核對課程版本及 macOS 相容資訊，不要直接套用舊教學裡的下載檔。安裝後可參考 Python 官方 Mac 使用說明檢查 macOS 上的使用方式。

Homebrew Python較適合已用 Homebrew 管理其他開發工具，或願意透過終端機安裝的學習者。Homebrew 的安裝流程與 macOS 要求以官方安裝文件為準；Python 套件的安裝與版本管理方式則可查看官方語言執行環境說明。沒有版本限制時，可以依文件安裝一般 Python 套件：

brew install python

如果課程要求指定版本，先確認 Homebrew 能否提供符合要求的版本；不能確認時，回到課程指定的安裝來源，或查看 Python 官方下載頁的選項。不要一邊保留不清楚用途的舊安裝、一邊反覆執行安裝命令，這通常只會讓終端機呼叫哪一套 Python 更難判斷。

安裝後檢查命令，再執行第一支程式

安裝完成後，先開啟終端機，確認它能找到 Python。macOS 上可先使用 python3 命令；Python 官方文件也說明，可用解譯器啟動互動式操作或執行程式（解譯器入門說明）。

python3 --version
which python3

第一行會顯示目前呼叫的 Python 版本，第二行會顯示命令所在路徑。把結果與課程要求對照：若版本不符，先看路徑是否指向預期安裝位置，再檢查終端機設定；不要在原因未明時重複安裝。

接著建立一個純文字檔，命名為 hello.py，輸入：

print("Hello, Python!")

在終端機切換到檔案所在資料夾，再執行：

python3 hello.py

若畫面出現 Hello, Python!，代表目前這個終端機命令已能執行該程式。若出現 command not found，先確認安裝是否完成、終端機是否需要重新開啟，以及安裝路徑是否已被終端機辨識；如果程式提示版本不符，回頭核對 python3 --version，不要把「程式碼錯誤」和「選錯解譯器」混為一談。

為每個課程專案建立自己的工具箱

虛擬環境可以理解成每個專案各自的工具箱：一個專案需要的套件放在自己的環境裡，不會不必要地混入另一個專案。Python 官方文件將 venv 說明為建立輕量、隔離環境的方式；文件也記載，從 Python 3.4 起建立環境時會預設安裝 pip（venv 官方說明）。

在專案資料夾中建立環境：

python3 -m venv .venv

在這裡，-m 代表以模組方式執行 Python 工具，venv 負責建立環境。接著在 macOS 終端機啟用環境：

source .venv/bin/activate

啟用後，終端機提示字元通常會帶有環境名稱。此時才安裝課程專案需要的套件。如果課程提供 requirements.txt，先確認自己在正確專案資料夾及已啟用環境，再執行：

python -m pip install -r requirements.txt

requirements.txt 是列出專案相依套件的常見檔案格式，可參考 pip 的需求檔案格式文件。若課程沒有提供套件清單，不要自行猜一串套件安裝；先按教材進度完成練習，需要套件時再依課程說明安裝。完成後輸入 deactivate，即可離開目前環境。Python Packaging User Guide 也整理了安裝套件與使用虛擬環境的步驟。

把常見安裝疑問先釐清

Mac 上怎麼安裝 Python，並確認第一支程式能執行？

先依課程要求選擇官方安裝器或 Homebrew，安裝後在終端機檢查 python3 --version，再用 which python3 確認命令找到的路徑。建立 hello.py 後執行 python3 hello.py。若命令不存在，先排查安裝和終端機設定，而不是連續安裝不同版本。

新手該選官方安裝器還是 Homebrew？

如果教材直接指定官方下載頁或需要特定版本，優先跟著教材及官方說明操作。若平常已使用 Homebrew 管理開發工具、課程也沒有版本限制，可以沿用 Homebrew。兩種方式的差別不只在安裝介面；更重要的是確認課程需要的版本是否能由該方式取得。

課程要求指定版本，但電腦上已有其他版本怎麼辦？

先以 python3 --version 和 which python3 查明目前使用的版本與路徑，再對照課程要求。若不吻合，選擇能提供指定版本的安裝來源，安裝後重新開啟終端機並再次檢查。不要只看「安裝成功」訊息，因為終端機仍可能呼叫另一個位置的 Python。

多個 Python 專案如何避免套件互相衝突？

在每個專案目錄分別建立 .venv，進入該專案時啟用相應環境，再安裝課程列出的套件。離開專案前可執行 deactivate；之後回來，要先重新啟用環境再執行程式。這樣更新一個專案的套件時，就不會把另一個專案的工具箱一起改動。

依課程限制判斷要用本機還是遠端

一般 Python 語法、檔案處理和多數入門作業，不必先有 Mac；若手邊的電腦可安裝課程所需的 Python 與編輯器，先在本機練習通常最直接。只有當課程明確要求 macOS 軟體、特定圖形介面或本機資源，而現有設備無法提供時，才需要評估其他環境。

學校電腦不允許安裝軟體時，先詢問課程是否提供指定設備或可接受的替代方式。遠端 Mac 則適合需要暫時使用 macOS、但手邊沒有 Mac 的練習者；PingMini 提供連線至託管 Mac 的方式，服務資訊列有 VNC、SSH 與網頁控制台等連線選項。開始前可先查看遠端 Mac 連線方式說明，並確認課程是否需要把檔案留在本機、連接特定裝置，或使用本機圖形介面。

遠端操作也有需要先考慮的限制：檔案可能要在本機與遠端環境之間移動；操作感受會受當下網路品質影響；若作業必須直接存取本機裝置，遠端環境未必符合要求。只做一般 Python 練習、手邊已有可用電腦，通常沒有必要額外改用遠端 Mac。

後續維護時先記錄版本與套件

環境能跑之後，為了讓作業下次仍能重現，請把課程版本、專案使用的套件清單和啟用方式留在專案筆記中。Python 官方 pip 指南說明了套件安裝與管理方式；若課程提供需求檔，按檔案內容安裝，不要把個人臨時試用的套件當成課程必要項目。

更新 Python 或套件前，先確認課程專案是否相容，再在對應的專案環境中操作。遇到錯誤時，保留完整訊息，並先核對目前路徑、Python 版本與虛擬環境狀態；只截取最後一行，常會漏掉真正指出問題位置的內容。開始新課程或新專案時，也要重新檢查要求，不要直接沿用上一份作業的環境假設。

Mac 設定 Python 開發環境的關鍵，不是追上最新版，而是讓課程要求、實際使用的解譯器與專案套件彼此一致。若本機能滿足作業需求，留在本機最省事；若課程要求 macOS、又暫時沒有合適設備，可以先檢查 PingMini 的方案資訊，再依連線方式與檔案需求判斷是否適合短期遠端練習，不必為了學 Python 先買 Mac。

常見問題