在 macOS 下升級 Python 有幾種常見的方法，具體取決于你最初是如何安裝 Python 的。了解你的安裝方式是關鍵。
首先，你需要知道你當前 Python 版本以及它的安裝路徑。
- 檢查 Python 版本：
python --version # 可能指向 Python 2.x
python3 --version # 通常指向 Python 3.x
- 檢查 Python 路徑：
which python
which python3
根據你 which 命令的輸出，我們可以推斷出安裝方式。常見的安裝方式有：
- macOS 系統自帶 Python： 通常在
/usr/bin/python。不建議直接修改或升級系統自帶的 Python，因為它可能被 macOS 的內部工具所依賴，直接操作可能導致系統不穩定。 - Homebrew 安裝： 通常在
/usr/local/bin/python3或/opt/homebrew/bin/python3(M1/M2 Mac)。這是 Mac 用戶最推薦和最方便的管理 Python 的方式。 - pyenv 安裝： 通常在
~/.pyenv/shims/python。pyenv 是一個強大的 Python 版本管理工具。 - Anaconda/Miniconda 安裝： 通常在
~/anaconda3/bin/python或~/miniconda3/bin/python。Anaconda 是一個全面的數據科學平臺。 - 直接從 Python 官網下載安裝包 (pkg)： 通常安裝到
/Library/Frameworks/Python.framework。
下面針對不同的安裝方式講解如何升級：
最推薦的方式：使用 Homebrew (如果還沒有安裝，強烈建議安裝)
Homebrew 是 macOS 上最流行的包管理器，也是管理 Python 版本的最佳方式之一。
1. 安裝 Homebrew (如果尚未安裝):
打開終端并運行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照屏幕上的指示完成安裝。
2. 升級 Homebrew 本身:
brew update
3. 升級 Python (如果已通過 Homebrew 安裝):
如果你的 Python 3 是通過 Homebrew 安裝的，只需運行：
brew upgrade python
這會把 Homebrew 版的 Python 升級到最新穩定版本。
4. 如果你尚未通過 Homebrew 安裝 Python 3，或者需要安裝特定版本:
brew install python # 這會安裝最新穩定版 Python 3
5. 確保你的 PATH 環境變量正確設置:
Homebrew 會自動將 /usr/local/bin (或 M1/M2 Mac 上的 /opt/homebrew/bin) 添加到你的 PATH 中，確保 Homebrew 安裝的 Python 優先于系統自帶的。在你的 ~/.zshrc (macOS Catalina及更高版本默認) 或 ~/.bash_profile (舊版本) 中確認有類似以下的行：
export PATH="/usr/local/opt/python/libexec/bin:$PATH" # 對于 Intel Mac
export PATH="/opt/homebrew/opt/python/libexec/bin:$PATH" # 對于 M1/M2 Mac
或者更通用的，確保 Homebrew 的 bin 目錄在 PATH 前面：
export PATH="/opt/homebrew/bin:$PATH" # For M1/M2 Mac
export PATH="/usr/local/bin:$PATH" # For Intel Mac
更新后，運行 source ~/.zshrc 或 source ~/.bash_profile 使其生效。
6. 驗證升級:
python3 --version
which python3
現在 python3 應該指向 Homebrew 安裝的最新版本。
使用 pyenv (推薦用于管理多個 Python 版本)
如果你需要在同一臺機器上管理多個 Python 版本（例如，項目 A 需要 Python 3.8，項目 B 需要 Python 3.10），pyenv 是一個絕佳的選擇。
1. 安裝 pyenv (如果尚未安裝):
brew install pyenv
然后，你需要將 pyenv 初始化添加到你的 shell 配置文件。編輯你的 ~/.zshrc (或 ~/.bash_profile)，添加以下行：
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
保存文件并運行 source ~/.zshrc。
2. 列出可用的 Python 版本:
pyenv install --list
3. 安裝新的 Python 版本 (即升級):
選擇你想要安裝的最新版本，例如 Python 3.11.x:
pyenv install 3.11.x # 將 x 替換為具體的最新補丁版本，如 3.11.4
4. 設置全局或局部 Python 版本:
- 全局設置 (對所有 shell 會話生效):
pyenv global 3.11.x
- 局部設置 (僅對當前目錄及其子目錄生效):
進入你的項目目錄，然后運行：
pyenv local 3.11.x
5. 驗證升級:
python --version
python3 --version
which python
which python3
pyenv 會通過修改 PATH 來“墊片” (shim) 你選擇的 Python 版本。
使用 Anaconda/Miniconda
如果你使用 Anaconda 或 Miniconda 管理 Python 環境，升級方式如下：
1. 更新 conda 本身:
conda update conda
2. 升級基礎環境中的 Python (不推薦，最好創建新環境):
如果你想直接升級 base 環境中的 Python，可以嘗試：
conda update python
但更推薦的做法是創建新的環境來管理不同的 Python 版本。
3. 創建一個新的環境并指定 Python 版本:
conda create -n my_new_env python=3.11
conda activate my_new_env
python --version
這樣你就可以在不同的環境中切換，每個環境有自己獨立的 Python 版本和庫。
從 Python 官網安裝包 (pkg) 升級
如果你最初是從 Python 官網下載的 .pkg 安裝包，你可以：
- 訪問 Python 官網： www.python.org/downloads/macos/
- 下載最新版本的 macOS 安裝程序。
- 運行下載的
.pkg文件。 它會引導你完成安裝，并通常會安裝在/Library/Frameworks/Python.framework下的一個新版本目錄中，并更新你的系統 PATH，使其指向最新的安裝。
注意： 這種方法可能會安裝多個 Python 版本在你的系統上，并且可能需要手動管理 PATH，不如 Homebrew 或 pyenv 靈活。
總結和最佳實踐：
- 永遠不要直接修改 macOS 系統自帶的 Python (
/usr/bin/python)。 - 對于大多數 Mac 用戶，使用 Homebrew 是最簡單、最推薦的方式來安裝和升級 Python 3。
- 如果你需要管理多個 Python 版本用于不同的項目，使用
pyenv是理想的選擇。 - 如果你進行數據科學或機器學習工作，并且依賴大量的科學計算庫，Anaconda/Miniconda 是一個強大的解決方案。
- 在升級 Python 后，記得重新安裝或更新你的項目依賴 (
pip install -r requirements.txt)，因為 Python 版本的變化可能會影響庫的兼容性。 - 始終在一個新的終端會話或使用
source命令來確保 PATH 環境變量的更改生效，然后再檢查 Python 版本。
選擇最適合你工作流程的方法。如果你是新手，Homebrew 是一個很好的開始。
