macOS下怎么安装Python 3:Homebrew与官方安装包对比

方予
方予
发布时间:2026-11-21 | 5人浏览过
原创

详细介绍在macOS系统下安装Python 3的两种主流途径:Homebrew与官网官方安装包(.pkg)。通过具体操作步骤、系统路径差异、PEP 668规范解析与多维度对比,帮助读者根据实际使用场景做出合适的技术选型。

在现代 macOS 系统(尤其是 macOS 12.3 移除系统自带 Python 2 之后)中,配置可用的 Python 3 开发环境主要有两种成熟路径:使用 macOS 社区最常用的包管理器 Homebrew,或者前往 Python 官网下载并运行 .pkg 安装包。本文将具体演示这两种方式的安装流程、环境配置与验证方法,并深入对比二者在文件路径、包管理机制以及后续维护上的核心差异,帮助你根据实际需求选择恰当的安装方案。

macOS下怎么安装Python 3:Homebrew与官方安装包对比
图 1:macOS 下 Homebrew 与官方安装包的技术架构与核心属性全景

方法一:使用 Homebrew 安装 Python 3

Homebrew 是 macOS 平台使用最广泛的第三方包管理工具。如果你的系统上已经配置了 Homebrew,安装 Python 3 仅需一行命令,这也是多数 macOS 开发者首选的方式。

1. 安装准备工作

在安装前,请打开 macOS 的“终端”(Terminal.app),确认系统已安装 Xcode 命令行开发者工具以及 Homebrew 本身:

# 检查并安装 Xcode 命令行工具(如果此前未安装)
xcode-select --install

# 检查 Homebrew 是否就绪并更新索引
brew update

2. 执行安装命令

在终端中直接运行以下命令。Homebrew 会自动解析依赖(如 openssl、sqlite、readline 等),下载预编译好的 Bottles 瓶装包并解压到对应目录:

brew install python

此命令会默认安装当前 Homebrew 仓库中的最新稳定版本 Python 3(例如 Python 3.12 或 3.13)。

3. 验证安装结果与执行路径

安装完成后,执行以下命令验证 Python 版本以及执行文件的实际落地点:

python3 --version
which python3
命令输出示例(Apple Silicon 芯片,如 M1/M2/M3/M4):
Python 3.12.6
/opt/homebrew/bin/python3
命令输出示例(Intel 芯片机型):
Python 3.12.6
/usr/local/bin/python3

注意:Homebrew 的 PEP 668 环境锁定策略

在较新的 Python 版本中,Homebrew 遵循了 PEP 668 标准。如果你尝试直接执行 pip3 install pandas,终端会提示 error: externally-managed-environment。这是为了防止用户全局安装的第三方包破坏 Homebrew 自身安装包的依赖关系。正确的做法是使用虚拟环境隔离项目依赖:

# 创建并激活隔离的虚拟环境
python3 -m venv my_project_env
source my_project_env/bin/activate

# 此时在虚拟环境中正常使用 pip,不会与系统环境冲突
pip install requests
macOS下怎么安装Python 3:Homebrew与官方安装包对比
图 2:Homebrew 安装 Python 3 的全流程与规范操作步骤

方法二:使用官网官方安装包(.pkg)安装

如果你不需要或未配置 Homebrew,或者希望在独立受控的目录结构中保持多版本 Python(例如同时拥有 3.10、3.11、3.12),Python 官方网站发布的 macOS .pkg 安装包是最稳妥的选择。

1. 下载安装包

访问 Python 官方网站(python.org)的 macOS 下载页面。目前的官方安装包采用统一的 macOS 64-bit universal2 installer 格式,原生兼容 Apple Silicon 芯片(arm64)与 Intel 芯片(x86_64)架构。双击下载完成的 .pkg 文件。

2. 图形化向导安装

跟随 macOS 标准安装器提示操作:

  1. 阅读并同意软件使用协议(License)。
  2. 在目标磁盘选择界面选择主系统盘。
  3. 输入 macOS 登录密码或通过 Touch ID 授权管理员权限,等待系统写入完成。

官方安装包会将完整的 Python 框架安放到系统框架目录:
/Library/Frameworks/Python.framework/Versions/3.x/
并在 /usr/local/bin/ 下自动建立指向该框架内部可执行文件的符号链接。

3. 核心后置配置:运行证书安装脚本(关键步骤)

使用官方安装包最容易被忽略且导致后续报错的一步是配置根证书。macOS 上的官方 Python 自带独立的 OpenSSL 库,并不会自动读取 macOS 系统的钥匙串(Keychain)信任证书。如果不执行证书更新,使用 urllib 或 requests 访问 HTTPS 链接时极易遇到 SSL: CERTIFICATE_VERIFY_FAILED 错误。

在安装完成后弹出的访达(Finder)应用程序文件夹窗口中,或者直接在终端中运行以下脚本完成配置:

# 运行官方提供的证书安装脚本(请将 3.12 替换为你安装的实际版本号)
/Applications/Python\ 3.12/Install\ Certificates.command
macOS下怎么安装Python 3:Homebrew与官方安装包对比
图 3:官方 PKG 安装包的安装顺序与关键证书配置流程

深度对比:Homebrew 与官方安装包的关键差异

为了让读者在实际选择时不产生混淆,我们需要从路径隔离、升级维护、多版本共存以及卸载复杂度四个维度进行实质性剖析。

对比维度 Homebrew 方式 官网安装包 (.pkg) 方式
安装位置 安装在 Homebrew 的 Cellar 目录下:
• Apple Silicon: /opt/homebrew/Cellar/python@3.x/
• Intel: /usr/local/Cellar/python@3.x/
安装在系统全局框架目录下:
/Library/Frameworks/Python.framework/Versions/3.x/
升级机制 命令统一管理:brew upgrade python
若有小版本发布,直接执行命令即可平滑替换旧版本。
手动下载安装新版本 .pkg 文件覆盖升级;若跨次版本(如 3.11 升级至 3.12),则会在系统内生成并行目录。
多版本共存 通过具体配方包管理(例如 brew install python@3.10 python@3.11),调用需显式使用 python3.10 或自行配置 PATH 别名。 天然支持多版本共存。所有版本并排放在 /Library/Frameworks/Python.framework/Versions/ 下,互不覆盖。
pip 与系统隔离 严格执行 PEP 668 规范,阻止用户在全局直接 pip install,强烈推行项目级 venv。 相对传统自由,允许用户向自身 Framework 目录全局安装第三方库,但缺乏隔离时可能造成依赖污染。
附带工具 纯净命令行工具链。默认不包含图形化 IDLE 编辑器,专注终端与代码开发。 包含完整的 IDLE 交互式编辑器与 Python Launcher 图形管理工具。
彻底卸载难度 极简:仅需执行 brew uninstall python 即可彻底删除全部本体文件。 较繁琐:需手动删除 Framework 目录、应用程序替身、/usr/local/bin 中的符号链接,并清理 ~/.zprofile 中的 PATH。
macOS下怎么安装Python 3:Homebrew与官方安装包对比
图 4:macOS Python 3 安装方式选型决策树与场景匹配指南

选型建议与总结:你该选哪一种?

面对这两种方式,很多初学者容易纠结。实际上,两者的核心区分并非“性能好坏”,而是你的工作流与系统维护习惯:

  • 如果你平时写代码、做数据分析或进行全栈开发:
    坚决推荐使用 Homebrew。现代 macOS 软件开发几乎不可避免地需要用到其它命令行工具(例如 Node.js、PostgreSQL、FFmpeg、Git 等)。将 Python 纳为 Homebrew 管理的一环,可以让升级、依赖排查和环境维护保持高度一致,不必记住各种不同目录的清理规则。
  • 如果你只是临时运行简单脚本、刚开始学习 Python 基础语法:
    或者你的高校课程、入门教程明确要求使用 Python 自带的 IDLE 编辑器完成作业,那么直接从官网下载 .pkg 安装包 是阻力最小的选择。你无需先行学习 Homebrew 的安装和环境配置,下载后按照向导即可立即上手。但切记,安装后必须运行一次 Install Certificates.command,避免后续安装依赖时被证书验证问题阻断。

最后需要强调的是:无论你采用上述哪种方式安装,在实际项目开发中,都应当养成使用虚拟环境(venv)的习惯。将第三方包隔离在项目专属的文件夹内,不仅能够彻底避免不同项目间的依赖冲突,也是当前 Python 社区推荐的通用规范。

相关专题:

本站声明

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

Python 相关产品和应用

全部下载

专题列表