在 macOS 下升级 Python 几种常见的方法

在 macOS 下升级 Python 有几种常见的方法，具体取决于你最初是如何安装 Python 的。了解你的安装方式是关键。

首先，你需要知道你当前 Python 版本以及它的安装路径。

1. 检查 Python 版本：

python --version # 可能指向 Python 2.x
python3 --version # 通常指向 Python 3.x

2. 检查 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 安装包，你可以：

1. 访问 Python 官网： www.python.org/downloads/macos/
2. 下载最新版本的 macOS 安装程序。
3. 运行下载的 .pkg 文件。 它会引导你完成安装，并通常会安装在 /Library/Frameworks/Python.framework 下的一个新版本目录中，并更新你的系统 PATH，使其指向最新的安装。

注意： 这种方法可能会安装多个 Python 版本在你的系统上，并且可能需要手动管理 PATH，不如 Homebrew 或 pyenv 灵活。

总结和最佳实践：

1. 永远不要直接修改 macOS 系统自带的 Python (/usr/bin/python)。
2. 对于大多数 Mac 用户，使用 Homebrew 是最简单、最推荐的方式来安装和升级 Python 3。
3. 如果你需要管理多个 Python 版本用于不同的项目，使用 pyenv 是理想的选择。
4. 如果你进行数据科学或机器学习工作，并且依赖大量的科学计算库，Anaconda/Miniconda 是一个强大的解决方案。
5. 在升级 Python 后，记得重新安装或更新你的项目依赖 (pip install -r requirements.txt)，因为 Python 版本的变化可能会影响库的兼容性。
6. 始终在一个新的终端会话或使用 source 命令来确保 PATH 环境变量的更改生效，然后再检查 Python 版本。

选择最适合你工作流程的方法。如果你是新手，Homebrew 是一个很好的开始。