Python 官方提供 macOS 下載頁及macOS 使用說明;先看課程指定版本,再安裝並用一個簡單程式驗證,才是設定 Mac Python 開發環境最穩妥的起點。你不必為了入門先裝一整套工具。
適合第一次在 Mac 上設定 Python、要完成課堂練習的學生;也適合照著教學操作,卻不確定解譯器是否正常的初學者。暫時沒有 Mac 實機、但課程需要 macOS 練習環境的學習者,也能參考最後的選擇建議。
先確認課程要求,再選 Python 版本
先翻課程講義、作業說明或老師提供的程式碼。找出指定的 Python 版本、建議的程式編輯器,以及是否要安裝額外套件。若課程明確指定版本,先跟著課程走,不要只因為官網提供較新的版本就自行更換。
Python 新手應該安裝哪個版本?
優先安裝課程或練習明確要求的版本;沒有指定時,再從 Python 官方 macOS 下載頁選擇適用版本。版本不符可能讓範例、套件或課堂指示對不上。只是練習變數、條件判斷和迴圈,不需要先安裝專案管理工具或一長串套件。
提醒:不要刪除或修改 macOS 管理的系統檔案來「清理」Python。不同 Mac 的預先安裝狀態可能不同;安裝來源、步驟與執行檔位置,請以當前的官方 macOS 說明為準。
準備安裝來源與終端
終端是輸入指令、啟動程式的工具。你可以從「應用程式」中的「工具程式」開啟它,也可以透過 Spotlight 搜尋「終端」。Apple 的終端使用指南說明了終端的基本操作;首次使用時,先認得提示字元與可輸入指令的位置即可。
接著,從 Python 官方 macOS 下載頁確認目前提供的安裝方式。不要把其他作業系統的安裝指令直接貼到 Mac,也不要假設每台 Mac 都已有相同版本或相同路徑。若課程已指定安裝方式,先確認它與官方文件相容,再按步驟操作。
安裝後用終端確認解譯器
安裝完成後,在終端輸入 python3 --version,再按 Return。這會要求終端啟動名為 python3 的命令並顯示版本資訊;Python 官方的macOS 使用說明可用來核對相關命令與執行方式。
Mac 上怎麼確認 Python 有沒有安裝成功?
如果終端回傳版本資訊,而且版本符合課程要求,解譯器已能透過這個命令啟動。若終端顯示找不到命令,問題在於命令或安裝位置尚未被終端辨識;若有版本資訊、但與課程要求不同,則是版本不符。兩種狀況的處理方式不同,先看清楚訊息再行動。
安裝 Python 後提示找不到命令怎麼辦?
先重新檢查是否依照官方 macOS 說明完成安裝,再確認輸入的命令是否為 python3。如果仍無法執行,查看官方文件所列的安裝方式與命令位置;不要猜測路徑,也不要直接修改系統設定。Apple 的執行終端命令說明也能幫你確認如何輸入及執行命令。
建立檔案,跑出第一個結果
先用你熟悉的文字編輯器建立檔案,命名為 hello.py,輸入:
print("Hello, Python!")
將檔案存到容易找到的位置,例如桌面上的練習資料夾。接著在終端切換到該資料夾,再輸入 python3 hello.py。切換資料夾的方式可以參考 Apple 的終端命令說明。
在 Mac 終端裡怎麼執行第一個 Python 檔案?
先確認終端目前所在的位置與 hello.py 的存放位置相同,再執行 python3 hello.py。若畫面出現 Hello, Python!,代表檔案可讀取、指令可啟動解譯器,最基本的執行流程已經通過。
如果沒有看到預期結果,按順序檢查:檔名是否真的以 .py 結尾、程式碼中的括號與引號是否成對、終端目前是否在正確資料夾,以及錯誤訊息是由編輯器還是終端顯示。編輯器的紅色提示可能只是語法檢查;程式內容錯誤則要看 Python 回報的行數與訊息;找不到命令才需要回頭查解譯器。
按練習需求逐步增加工具
單一檔案能正常執行後,再看課程是否要求額外編輯器、第三方套件或專案依賴隔離。初學階段先把課堂範例跑通,再按需要加工具,可以避免同時處理安裝問題、編輯器設定和程式錯誤。
當不同練習需要不同套件時,可以了解 Python 內建的 venv。官方虛擬環境說明介紹如何建立隔離環境;若課程要安裝第三方套件,則依照Python 模組安裝文件及課堂要求操作。不要在還沒弄清楚練習需求前,先安裝一堆不會用到的套件。
設定檢查清單
- [ ] 已確認課程要求的 Python 版本與安裝方式。
- [ ] 已從官方 macOS 頁面核對下載資訊。
- [ ] 終端能顯示 Python 版本,且版本符合課程要求。
- [ ]
hello.py能執行並輸出預期文字。 - [ ] 只有在課程或專案需要時,才新增編輯器、套件或隔離環境。
用對照表判斷下一步
| 你的情況 | 建議做法 | 成功標誌 |
|---|---|---|
| 課程指定 Python 版本 | 先依課程要求安裝,並核對官方說明 | 終端顯示符合要求的版本 |
| 課程沒有指定版本,只做基礎練習 | 從官方 macOS 下載頁選擇適用版本 | 最小程式能正常執行 |
終端找不到 python3 |
回查安裝步驟、命令與官方文件 | 終端能辨識命令並顯示版本 |
| 有版本資訊,但作業仍無法執行 | 核對課程版本、檔案位置與錯誤訊息 | 確認錯誤來自版本、路徑或程式內容 |
| 安裝後的狀況 | 優先檢查 | 不要先做的事 |
|---|---|---|
| 沒有版本資訊,顯示命令不存在 | 安裝是否完成、終端命令是否正確 | 猜路徑或刪除系統檔案 |
| 有版本資訊,但不符合課程要求 | 版本要求與目前安裝版本 | 直接更新,忽略課程相容性 |
| 版本正確,但腳本無法執行 | 檔案名稱、資料夾位置與程式碼 | 把所有錯誤都當成安裝失敗 |
| 單一練習能執行,專案需要套件隔離 | 課程是否要求 venv 或第三方套件 |
未確認需求就安裝多套工具 |
| 學習情境 | 適合的環境 | 主要取捨 |
|---|---|---|
| Python 基礎與一般練習 | 手邊可用的 Windows 或 Mac 電腦 | 不必為 Python 入門特地購買 Mac |
| 課程明確要求 macOS 專用工具 | 可使用的 Mac 環境 | 先確認課程操作與檔案保存方式 |
| 暫時沒有 Mac,但要完成 macOS 練習 | 評估遠端 Mac 是否符合課程需要 | 需考慮網路連線與遠端操作方式 |
| 長期固定使用、且需要本機操作 | 自購 Mac 或現有本機設備 | 需自行承擔設備成本與維護 |
Python 入門本身不代表你一定要用 Mac。若課程只教一般 Python 基礎,先用現有電腦完成練習即可;但若作業確實要求 macOS 工具,Windows 本機會遇到系統環境不符、無法直接使用相關軟體,以及需要另找設備等限制。自購 Mac 適合長期固定使用、需要本機操作的人;若你只是階段性需要 macOS 練習環境,可再了解 vmzig 的遠端 Mac 使用方式,評估遠端連線是否適合課程。先確認課程要求,再決定是否需要 Mac,會比為了學 Python 先買設備更合算。
vmzig M4 遠端節點
沒有合適的 Mac,也能開始練習 Python
vmzig 提供遠端 Mac 租用,讓您透過遠端環境練習 Python,不必先添購 Mac。