macOS怎么安装最新版Python?pkg安装包与Homebrew方法对比

Cora
Cora
发布时间:2026-11-19 | 12人浏览过
原创

在macOS上安装最新版Python主要有两种推荐途径:通过Python官网下载官方.pkg图形安装包,或者使用Homebrew命令行包管理器。本文详细对比两种安装方式的操作步骤、文件安装路径、后续更新与包管理差异,并针对初学者与专业开发者给出明确的选择建议。

在macOS上安装最新版Python主要有两种官方与社区广泛认可的途径:一是直接从Python官方网站下载图形化.pkg安装包完成向导安装,二是通过macOS常用的命令行包管理器Homebrew执行命令安装。两种方式都能在系统自带环境之外提供完整、现代的独立Python运行环境,但在依赖管理、安装路径、后续升级便捷度以及对系统安全策略(如PEP 668)的处理上各有不同特点。

一、macOS的Python环境现状与安装准备

在开始安装前,需要明确macOS系统内置的Python情况。从macOS Monterey 12.3起,苹果已彻底移除了系统内置的遗留Python 2。目前系统自带或随Xcode Command Line Tools附带的python3(通常位于/usr/bin/python3)主要服务于系统内部组件与开发工具链,其版本更新完全绑定系统补丁,且苹果明确限制用户直接向系统全局目录写入第三方模块。

因此,无论是进行日常学习、数据分析还是Web开发,都需要在系统中安装独立的最新版Python。在开始操作前,读者可在终端执行以下命令查看当前已有环境:

# 查看当前默认python3的路径
which python3

# 查看当前python3版本号
python3 --version

终端返回的如果是系统路径(如/usr/bin/python3),说明当前尚未配置用户级独立Python环境。接下来可以根据自身的使用偏好选择pkg图形安装或Homebrew命令行安装。

macOS怎么安装最新版Python?pkg安装包与Homebrew方法对比
图 1:macOS 安装 Python 的双轨决策与架构特征

二、方法一:使用官方 .pkg 安装包安装

通过 Python 官方网站提供的 macOS 64-bit universal2 安装程序(.pkg 文件)进行安装,是官方推荐面向个人终端用户的标准方式。universal2 格式原生兼顾了 Apple Silicon(M1/M2/M3/M4 系列芯片)与 Intel 处理器的执行效率。

1. 完整操作步骤

  1. 下载安装包:使用浏览器访问官方下载页面 https://www.python.org/downloads/macos/,找到当前稳定发行版的“macOS 64-bit universal2 installer”,下载后缀为 .pkg 的安装文件。
  2. 运行图形向导:双击下载的 .pkg 文件,根据提示依次点击“继续”、“同意许可协议”,并在选择安装目标磁盘后点击“安装”。安装过程通常需要输入一次 macOS 用户登录密码以授予写入系统框架目录的权限。
  3. 运行证书安装脚本(重要步骤):安装完成后,系统会自动打开 Applications(应用程序)下的 Python 文件夹。务必双击其中的 Install Certificates.command 脚本。由于 macOS 版本的官方 Python 捆绑了独立的 OpenSSL 库,不自动使用 macOS 钥匙串根证书,运行该脚本会通过 pip 下载安装 certifi 证书包,彻底避免后续在代码中使用 urllib 或 requests 访问 HTTPS 网址时出现 SSL: CERTIFICATE_VERIFY_FAILED 错误。

2. 环境变量与目录布局

官方 pkg 安装程序会将 Python 核心框架安装至全局目录 /Library/Frameworks/Python.framework/Versions/<版本号>/,并在 /usr/local/bin 目录下建立可执行程序的软链接,包括 python3、pip3 以及对应次版本号的软链接(如 python3.12)。同时,安装程序会自动检查并更新家目录下的配置文件(如 ~/.zprofile 或 ~/.bash_profile),将对应路径加入 $PATH。

macOS怎么安装最新版Python?pkg安装包与Homebrew方法对比
图 2:官方 .pkg 安装包执行步骤与核心文件系统落盘路径

三、方法二:使用 Homebrew 命令行安装

Homebrew 是 macOS 平台使用最广泛的软件包管理器。如果读者从事开发工作,系统中通常已经配置了 Homebrew,此时通过命令行安装与维护 Python 能够实现高度统一的工具流管理。

1. 完整操作步骤

  1. 更新 Homebrew 索引:在终端中先拉取最新的 Formulae 索引,确保安装的是最新发布的 Python 构建版本:
    brew update
  2. 安装最新版 Python:
    brew install python
    如果需要安装特定的次版本(例如需要兼顾某些仅支持特定版本的项目),也可以明确指定版本安装,例如 brew install python@3.11。
  3. 确认环境与别名:安装完成后,Homebrew 会自动配置软链接。可在终端中确认其具体路径与版本:
    # 确认定位到 Homebrew 提供的二进制
    which python3
    
    # 输出示例(Apple Silicon 芯片):
    # /opt/homebrew/bin/python3

2. PEP 668“外部管理环境”规范与 pip 变化

采用 Homebrew 安装最新版 Python 的读者通常会遇到一个关键机制:在全局直接运行 pip3 install <package> 时,终端会抛出 error: externally-managed-environment 错误。这是 Python 官方在 PEP 668 中引入的安全保护机制,Homebrew 自 Python 3.11/3.12 起严格启用了该标记。

注意:为什么不要用 --break-system-packages 强行绕过?

Homebrew 本身是用 Python 维护部分底层依赖组件的。如果通过全局 pip 随意覆盖基础库,会导致 Homebrew 后续在执行 brew upgrade 时出现依赖冲突或符号损坏。官方推荐的正确方式是:在项目目录下使用虚拟环境。

正确的项目依赖安装步骤如下:

# 1. 进入您的项目目录
cd ~/my_project

# 2. 创建独立的虚拟环境(指定目录名为 .venv)
python3 -m venv .venv

# 3. 激活该虚拟环境
source .venv/bin/activate

# 4. 在隔离环境中安全安装所需包
pip install requests pandas
macOS怎么安装最新版Python?pkg安装包与Homebrew方法对比
图 3:Homebrew 环境下的安装流程与 PEP 668 项目虚拟环境工作流

四、两种安装方式全维度对比

为了帮助读者根据实际工作流选择最合适的方式,下表从安装体验、存储布局、更新维护及多版本管理等维度进行横向对比:

对比维度 官方 .pkg 安装包 Homebrew 包管理器
安装门槛 极低,图形化双击向导,与安装普通 Mac 软件一致 中等,需要先安装 Homebrew 并熟悉基本终端命令
安装文件路径 /Library/Frameworks/Python.framework /opt/homebrew/ (Apple Silicon) 或 /usr/local/ (Intel)
附加组件 内置 IDLE 简易开发环境、Python 文档与 macOS 启动器 仅包含核心运行时与命令行工具,环境极致精简
升级与维护 需要手动下载新版本 .pkg 覆盖或并存安装 一条命令 brew upgrade python 即可自动更新到最新小版本
多版本共存 天然支持按次版本号共存(如 python3.11 与 python3.12),但卸载需手动删除框架目录 支持同时安装 python@3.10、python@3.11,切换与卸载方便
全局 pip 行为 默认允许直接向用户或全局目录安装模块,需手动运行证书脚本 强制启用 PEP 668,避免污染公共环境,证书链自动打通
macOS怎么安装最新版Python?pkg安装包与Homebrew方法对比
图 4:两种安装方式多维度对比与选型决策矩阵

五、安装后的验证与环境自检

无论采用上述哪种方式完成安装,都建议在终端中进行标准化验证,确保系统正确识别了新安装的 Python 解释器及其包管理器。

1. 验证解释器版本与路径

重新打开一个新的终端窗口(确保加载最新的环境变量配置),依次执行以下命令:

# 1. 查看默认 python3 版本
python3 --version

# 2. 查看当前调用的实际二进制路径
which python3

# 3. 验证 pip3 工具是否正常绑定
pip3 --version

如果输出的版本号与您刚下载或安装的最新版本一致,且路径指向 /Library/Frameworks/Python.framework/...(pkg 安装)或 /opt/homebrew/bin/python3(Homebrew 安装),则表明安装配置已全部就绪。

2. 常见问题排查

  • 终端依然输出系统旧版 /usr/bin/python3:通常是因为新路径未排在环境变量 $PATH 的最前端。如果是 zsh(macOS 默认 shell),可检查 ~/.zprofile 或 ~/.zshrc 中是否包含路径导出语句(如 export PATH="/usr/local/bin:$PATH" 或 eval "$(/opt/homebrew/bin/brew shellenv)")。修改保存后执行 source ~/.zshrc 即可刷新。
  • 运行 pip 时提示 SSL 证书错误:如果是 pkg 安装方式,请重新在访达中进入“应用程序 > Python 3.x”文件夹,再次双击运行 Install Certificates.command 即可解决。

掌握了安装路径的差异与包隔离机制后,读者便可以根据实际工作场景自由切换或规范配置 macOS 上的 Python 开发环境。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表