目次
1. 簡介
Python 版本降級的必要性
Python 是在程式設計與資料科學領域廣泛使用的語言，但有時需要使用特定的版本。以下是會降級版本的情況：
- 庫與工具的相容性問題
部分庫與框架僅支援特定的 Python 版本。例如，舊版 TensorFlow 僅能在 Python 3.9 以前運行。 - 專案需求
在團隊開發時，可能需要全專案統一使用相同的版本。 - 穩定性的確保
當最新版本剛發布時，可能缺乏穩定性，因此也可能希望使用已經穩定的舊版本。
本文將說明在 Windows、macOS、Linux 各環境中將 Python 版本降級的具體步驟。此外，還會詳細介紹使用虛擬環境進行彈性版本管理的方法，以及降級時的注意事項。
2. How to Check the Current Python Version
Importance of Checking the Current Python Version
在降級 Python 版本之前，確認目前已安裝的版本是很重要的。這樣可以了解系統上 Python 的狀態，並能順利切換。此外，若依賴環境變數或虛擬環境，可能會混在多個版本，因此確認作業不可或缺。
Checking Python Version Using the Command Line
確認 Python 版本的方法主要是使用命令列（終端機）。以下示範各作業系統的步驟。
How to Check Python Version on Windows
- Open Command Prompt
- 按下 Windows 鍵，輸入「cmd」並選取「命令提示字元」。
- Enter the command to check Python version
Enter one of the following:
python --version或
python3 --version- Check the output
Example:
Python 3.11.5How to Check Python Version on macOS
- Open Terminal
從 Finder 選擇「應用程式 > 公用程式 > 終端機」。 - Enter the command to check Python version
python3 --version- Check the output
在 macOS 上，系統預設可能已安裝 Python 2 系列。若要使用 Python 3 系列，必須指定python3。
How to Check Python Version on Linux (e.g., Ubuntu)
- Open Terminal
使用鍵盤快捷鍵（Ctrl + Alt + T）啟動終端機。 - Enter the command to check Python version
python3 --version- Check the output
Example:
Python 3.9.13Checking Installation Location (Environment Variables and Path)
在確認版本後，視需要檢查安裝位置。這樣即使在存在多個 Python 版本的環境中，也能適當切換版本。
Command to Check Python Installation Location
- Windows:
where python- macOS/Linux:
which python3Notes
- If the version is not displayed correctly
可能是環境變數或路徑設定有問題。此時請檢查路徑設定，並修正設定以確保正確的 Python 二進位檔被引用。 - If multiple versions are installed
在同一環境中若同時存在多個 Python 版本，可能無法使用預期的版本。此時建議使用虛擬環境（詳情如下）。
3. Python 降級步驟（依作業系統）
根據降級目的選擇步驟
Python 的降級依據使用的作業系統而有不同步驟。以下將詳細說明 Windows、macOS、Linux 各作業系統的降級方法。說明使用官方網站的安裝程式以及 pyenv 等工具的步驟，讓人容易理解。
3.1 Windows 的情況
步驟1: 下載舊版安裝程式
- 存取官方網站
Python 官方下載頁面 - 搜尋目標版本
點擊頁面底部的「View the full list of downloads」，從過去版本清單中選擇所需的版本。 - 下載適當的安裝程式
- 選擇 Windows 用的「Executable Installer」。
- 確認是 64 位元版或 32 位元版，並下載相應的安裝程式。
步驟2: 安裝
- 若有需要，解除安裝現有的 Python
- 在「控制面板 > 程式解除安裝」中刪除現有的 Python。
- 安裝新版本
執行下載的安裝程式，勾選「Add Python to PATH」後繼續安裝。
步驟3: 確認環境變數
- 確認環境變數是否正確
- 按下「Windows 鍵 + R」 → 輸入「sysdm.cpl」 → 開啟「環境變數」分頁。
PATH中是否包含 Python 的安裝路徑。
- 再次確認 Python 版本
python --version3.2 macOS 的情況
步驟1: 安裝 pyenv
- 確認 Homebrew
macOS 使用 Homebrew。於終端機輸入以下指令以確認是否已安裝 Homebrew。
brew --version若未安裝，請參考官方網站進行安裝。
- 安裝 pyenv
在終端機執行以下指令：
brew install pyenv步驟2: 安裝 Python 版本
- 確認可安裝的版本
pyenv install --list確認所需版本，並使用以下指令安裝：
pyenv install 3.9.7- 切換全域版本
pyenv global 3.9.7- 確認版本
python --version3.3 Linux（Ubuntu）的情況
步驟1: 使用 update-alternatives
- 確認已安裝的 Python 版本
python3 --version- 新增新版本
使用以下指令安裝特定版本：
sudo apt install python3.x- 切換預設版本
sudo update-alternatives --config python3從顯示的清單中選擇想使用的版本。
步驟2: 使用 PPA（如有需要）
若特定版本在套件庫中不存在，請新增 PPA（Personal Package Archive）。
- 新增 PPA
sudo add-apt-repository ppa:deadsnakes/ppa- 安裝版本
sudo apt update
sudo apt install python3.9注意事項
- 明確的版本管理
若安裝多個版本，建議使用pyenv或虛擬環境，讓每個專案使用不同的版本。 - 注意相依性
因系統上其他應用程式可能受影響，請事先確認。
4. 使用虛擬環境的 Python 版本管理
使用虛擬環境的原因
透過使用虛擬環境，可在不影響系統整體 Python 版本的情況下，為每個專案管理不同的 Python 版本與函式庫。藉此解決多專案的相容性問題，並將降級的需求降至最低。
虛擬環境的基本工具
venv
- Python 內建的虛擬環境管理工具
可於 Python 3.3 之後使用。 - 適合用於建立簡單且輕量的虛擬環境。
virtualenv
- 作為外部工具提供的虛擬管理工具
比 venv 功能更豐富，且相容於 Python 2 系列。 - 在需要彈性設定與管理虛擬環境時相當便利。
pyenv-virtualenv
- 在 pyenv 中加入虛擬環境功能的擴充
可統合管理多個 Python 版本與虛擬環境。
虛擬環境的建立與使用方法
使用 venv 時
- 建立虛擬環境
在終端機或命令提示字元中執行以下指令：
python3 -m venv myenvmyenv是虛擬環境的名稱。可以自行更改為任意名稱。
- 啟用虛擬環境
- Windows:
myenvScriptsctivate - macOS/Linux:
source myenv/bin/activate
- 檢查虛擬環境
當虛擬環境被啟用時，提示字元會顯示環境名稱（例:(myenv)）。
(myenv) $- 停用虛擬環境
deactivate使用 virtualenv 時
- 安裝 virtualenv
pip install virtualenv- 建立虛擬環境
virtualenv myenv- 啟用/停用虛擬環境
可使用與 venv 相同的步驟操作。
使用 pyenv-virtualenv 時
- 安裝 pyenv-virtualenv
brew install pyenv-virtualenv- 建立虛擬環境
pyenv virtualenv 3.9.7 myenv- 啟用虛擬環境
pyenv activate myenv- 停用虛擬環境
pyenv deactivate虛擬環境的活用案例
- 每個專案使用不同的 Python 版本
透過使用虛擬環境，可在某個專案使用 Python 3.9，另一個專案使用 Python 3.11，實現此類運作方式。 - 鎖定函式庫版本
requirements.txt透過建立，虛擬環境內安裝的函式庫版本得以紀錄，確保可重現性。
pip freeze > requirements.txt- 測試環境的分離
將開發環境與正式環境以虛擬環境分開管理，可將測試與部署時的錯誤降至最低。
注意事項
- 將虛擬環境的名稱與位置明確化，可防止在管理多個環境時產生混亂。
- 即使使用虛擬環境，仍有部分依賴系統 Python 的工具（例：OS 專屬的套件管理工具）可能會受到影響。
5. 注意點與故障排除
降級時的注意點
在將 Python 版本降級時，需要掌握一些注意事項。如果不遵循適當的步驟，可能會對系統或專案造成意外的問題。
5.1 相依關係的問題
- 確認影響範圍
請確認依賴於將要降級的 Python 版本的函式庫與工具是否能正常運作。特別需要注意以下幾點： - 目前使用的專案中運作的函式庫僅支援較新版本的 Python。
pip使用的套件相容性。- 對策
- 在降級後重新安裝所有函式庫：
pip install -r requirements.txt
5.2 環境變數與路徑設定的問題
- 症狀
降級後，Python 指令可能不會指向正確的版本。這是因為環境變數或路徑設定有問題所致。 - 確認方法
- Windows:
where python - macOS/Linux:
which python3 - 解決方案
透過修正路徑設定即可解決問題。以下是 Windows 的步驟：
- 開啟「系統屬性」 > 「環境變數」
PATH變數，編輯並確認已包含降級後的 Python 安裝目錄。- 刪除不需要的項目（舊的路徑）。
5.3 版本切換未生效的問題
- 症狀
在終端機中確認的版本與預期的不符。 - 解決方案
- 如果使用 pyenv，請執行以下指令以明確設定版本：
pyenv rehash
此外，若要在整個系統使用，請使用 pyenv global 指令。
故障排除範例
錯誤範例1: 「Python not found」顯示
- 原因
環境變數中未設定 Python 的安裝路徑，或設定錯誤。 - 解決方案
確認安裝路徑，並在環境變數中加入正確的路徑。
錯誤範例2: 無法匯入函式庫
- 原因
因降級導致函式庫處於未安裝狀態。 - 解決方案
重新安裝必要的函式庫：
pip install 套件名稱
錯誤範例3: 顯示「No module named ‘pip’」
- 原因
pip 未安裝或已損壞。 - 解決方案
重新安裝 pip：
python -m ensurepip
python -m pip install --upgrade pip降級後的確認項目
- 確認 Python 版本
在終端機執行以下指令，確認已切換至正確的版本：
python --version- 函式庫的運作確認
確認主要函式庫是否正常運作，並實際執行專案以驗證。
6. 總結
回顧本文
本文說明了將 Python 版本降級的具體步驟，以下要點進行了詳細解說：
- Python 版本確認方法
說明了在各作業系統（Windows、macOS、Linux）上確認 Python 目前版本的方法。 - 各作業系統的降級步驟
在 Windows 上使用官方安裝程式，在 macOS 上利用pyenv的步驟，Linux 則說明了使用update-alternatives或 PPA 進行安裝的方法。 - 虛擬環境的使用
作為在每個專案中管理不同 Python 版本與函式庫的方法，介紹了venv、virtualenv、pyenv-virtualenv的使用方式。 - 注意事項與故障排除
說明了降級時容易發生的問題與錯誤原因，並以具體範例說明其解決方案。
適切的 Python 版本管理的重要性
Python 的版本管理對開發的效率與穩定性有重大影響。降級往往是暫時的解決方案，透過以下方法可使長期管理更為容易：
- 使用虛擬環境
透過為每個專案建立獨立的環境，可在不影響整個系統的情況下彈性管理版本與函式庫。 - 使用 pyenv
使用能有效管理多個 Python 版本的工具，可將降級與升級的工作量降至最低。
未來的行動
- 依照步驟降級 Python
請參考本文說明的方法，依適當的步驟切換版本。 - 嘗試使用虛擬環境
透過使用虛擬環境，可實現專案的高效管理。特別是在開始新專案時，建議一開始就設定虛擬環境。
給讀者的訊息
Python 的版本管理是從初學者到進階者都無法迴避的課題。希望本文能協助您整理開發環境，促進專案順利進行。若對包括降級在內的版本管理有任何疑問或問題，歡迎隨時詢問！
