Python 3.15.0 已於 2026 年 10 月 9 日正式發布;一般課程先選標準版,安裝器中的 free-threaded 版只在課程明確要求或你要測試相容性時再用。Python.org 發布記錄及官方 macOS 安裝說明確認,額外版本可與標準版並存,不是新手必須切換的預設路線。
第一次在 Mac 安裝 Python 3.15、只想完成課程練習的學生,可以先按本文選擇解釋器。
已有專案、擔心套件能否在 free-threaded 版運作的學習者,可用依賴檢查步驟逐項核對。
透過遠端 Mac 學習、需要確認終端機實際執行哪個 Python 的 Windows 學生,也適合參考下方驗收清單。
最後更新於 2026 年 10 月 10 日;版本與安裝選項核對自 Python.org 3.15.0 發布頁及Python 3.15 macOS 文件。套件支援狀況仍須依你課程的實際依賴檢查。
01 Python 3.15 Mac 安裝選項:先看課程相容性
如果老師指定 Python 版本,先按課程要求建立環境,不要只因為 3.15 是新版本就直接替換。課程講義、範例程式和作業評分環境,可能都以指定版本為基準。
可把解釋器想成課程工具箱的底座:底座不同,某些工具或套件就可能無法照講義操作。若課程已指定 Python 3.15,仍先用標準版完成一般作業;只有作業明確要求 free-threaded,才需要再準備另一個環境。
標準版和 free-threaded 版差在哪裡?
標準版是日常課程與一般程式練習的預設選擇。free-threaded 是另一種建置方式,目標是讓 Python 執行緒在特定條件下不受 GIL 限制;GIL 可簡單理解為 Python 執行程式時用來管理執行緒的一道鎖。它不是「更新版」的意思,也不能直接當成所有程式都會變快的保證。Python 官方說明也指出,實際表現須看程式與依賴套件。
02 解釋器辨認:確認終端機執行哪個版本
安裝了不同建置,不代表它們互相衝突;真正要確認的是目前的終端機命令指向哪一個解釋器。解釋器就是負責讀取並執行 Python 程式的程式本身。Python 的 macOS 文件列有標準版與 free-threaded 版的使用方式,後者的命令名稱帶有 t,例如 python3.15t。官方 macOS 文件
Python 3.15t 怎麼確認目前執行的是哪個解釋器?
在終端機分別執行下列命令,再比較輸出的路徑與版本。sys.executable 會顯示正在執行的 Python 路徑;Python 官方 sys 文件說明了相關資訊。
python3.15 -c "import sys; print(sys.executable); print(sys.version)"
python3.15t -c "import sys; print(sys.executable); print(sys.version)"
若你只輸入 python 或 python3,系統找到的命令未必是課程要求的版本。遇到「明明安裝了,結果和講義不同」時,先檢查完整路徑與版本輸出,不要立刻把它當成程式碼錯誤。
若要進一步確認 free-threaded 執行時目前是否啟用了 GIL,可在該版本執行:
python3.15t -c "import sys; print(sys._is_gil_enabled())"
這個結果反映執行當下的狀態,不應單獨用來判斷你安裝的是哪個程式;以解釋器路徑、版本和課程需要一起核對較可靠。
03 第三方套件:按課程依賴逐項檢查
課程範例可能只用 Python 內建功能,也可能安裝影像處理、資料分析或其他第三方套件。部分套件是純 Python 寫成;另一些包含擴充模組,也就是由其他程式語言編譯、再接到 Python 使用的元件。後者需要相應的相容支援,不能只憑套件名稱猜測。
Python 3.15 free-threaded 版能跑課程套件嗎?
可能可以,也可能遇到尚未適配的擴充模組;必須以課程實際用到的套件為準。Python 官方文件明確提醒,部分擴充模組可能尚未支援 free-threaded 執行,或在執行時重新啟用 GIL。官方擴充模組支援說明並不等同於某一門課的套件相容清單,因此不要把未確認的套件說成必定支援或必定不能用。
核對時,先查看課程的依賴檔或安裝指示,再查每個套件自己的官方安裝及支援說明。若一般版能安裝並通過課程範例,而 free-threaded 版發生匯入錯誤,先回到標準版完成作業,再把問題縮小到個別依賴。
注意:不要在同一個專案環境中交錯安裝兩種 Python 的套件。環境混在一起後,錯誤訊息會更難追查。
04 學習任務:只在需要時測試 free-threaded
依課程任務分流,比看到安裝器選項就勾選更穩妥:
- 一般語法、函式、檔案處理或課程作業:使用標準版。這類學習目標通常不要求改用另一種建置。
- 課程明確要求 free-threaded:按課程指定方式建立獨立環境,並用指定範例驗收。
- 你正在測試並行程式或套件適配:另開測試專案,同時記錄解釋器路徑、套件版本和執行結果。
free-threaded 的設計與執行緒有關,不代表它會讓所有作業自動加速。若程式沒有相應的並行工作,或依賴尚未適配,切換版本反而可能增加排錯工作。標準課程練習先留在標準版,能讓你把注意力放回課程本身。
05 虛擬環境:隔離專案並保留退路
Python 虛擬環境可以想成每個專案各自使用的一張工作桌:套件安裝在專案自己的位置,不必和其他課程共用一套依賴。Python 官方提供 venv 說明及pip 與虛擬環境指南;建立專案環境時,先確認你呼叫的是標準版還是 free-threaded 版。
一般課程可在專案資料夾執行:
python3.15 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
如果課程使用的是其他依賴清單或安裝方式,遵循課程文件,不要自行假設一定有 requirements.txt。測試 free-threaded 時,另用該解釋器建立不同名稱的環境,不要把測試套件裝進標準版的 .venv。
06 課程驗收清單:按順序確認環境
以下清單可先用在一個課程範例或作業專案。每完成一項,再進到下一項;出現錯誤時保留命令與訊息,避免一次改動多個設定。
- [ ] 查看課程講義,記下指定的 Python 版本與套件安裝方式。
- [ ] 執行
python3.15 --version,確認標準版命令回報預期版本;若課程要求其他版本,以課程指定為準。 - [ ] 執行
python3.15 -c "import sys; print(sys.executable)",確認路徑指向預期的解釋器。 - [ ] 用課程指定的 Python 建立專案虛擬環境,啟用後再安裝依賴。
- [ ] 依課程清單逐項匯入套件,並記錄是安裝失敗、匯入失敗,還是程式執行階段才出錯。
- [ ] 直接執行一項課程範例或作業,確認結果符合講義要求;只顯示版本號不算完成驗收。
- [ ] 若要測試 free-threaded,使用獨立環境重做相關檢查,並確認終端機執行的是帶
t的解釋器命令。 - [ ] 若測試版無法安裝依賴或跑不過範例,切回課程指定的標準環境;不要覆蓋系統 Python,也不要改動學校管理員保護的目錄。
學校電腦若限制安裝權限,先遵守管理規則,不要嘗試繞過保護設定。需要比較不同 Python 時,記錄你使用的命令、解釋器路徑和錯誤訊息,之後才能分清是權限問題、版本選錯,還是套件尚未支援。
若你目前用 Windows,但課程要求在 macOS 驗收,單靠本機安裝無法核對 Mac 上的實際執行結果。可先看 CALMVPS 的遠端 Mac 學習環境是否符合你的使用情況;若只是需要短期完成課程核驗,先比較遠端 Mac 使用方案,再決定是否需要租用。
對只需完成一般 Python 課程的學生,先用標準版、隔離專案並跑通一項作業即可;free-threaded 留給課程要求或明確的測試任務。若你沒有本地 Mac,卻必須在 macOS 環境完成這次驗收,購買一台設備會帶來較高的前期支出與日常維護,Windows 本機也無法直接代替 Mac 環境,而在學校受限制的電腦上可能無法自行安裝所需工具。這些情況下,租用 CALMVPS 遠端 Mac 可讓你在需要時核對專案;若你要長期高頻使用、需要實體介面,或學校已有合規設備,則先用現有環境更合適。