在 macOS 下升级 Python 几种常见的方法
在 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 是一个很好的开始。