macOS安装Python的两种方法:官方安装包与Homebrew对比

林见深
林见深
发布时间:2026-10-21| 3人浏览过
原创

macOS 目前不再随系统内置开箱即用的完整 Python 3 开发环境。要在 Mac 上编写脚本或进行软件开发,用户需要自行安装新版 Python。在众多安装方式中,直接从 Python 官方网站下载 pkg 安装包,以及使用 macOS 广泛流行的包管理工具 Homebrew 安装,是两种最通用且最受推荐的途径。本文将分别演示这两种方法的完整操作流程与环境验证,并从文件路径、后续升级、卸载清理和使用场景四个关键维度进行横向对比,帮助读者选出最符合当下需求的方案。

方法一:使用官方安装包(pkg)安装

官方安装包是 Python 软件基金会针对 macOS 专门打包的图形化安装程序。这种方式不依赖任何第三方命令行工具,完全符合 Mac 用户的常规软件安装直觉。

1. 下载与安装步骤

  1. 打开浏览器访问 Python 官方网站的下载页面,定位至 macOS 平台,下载当前稳定版的 macOS 64-bit universal2 installer(.pkg 格式)。
  2. 双击下载完成的 .pkg 文件,启动标准安装引导程序。
  3. 根据界面提示,连续点击“继续”以接受软件许可协议,并保持默认的安装目标磁盘不变。
  4. 点击“安装”,输入 macOS 登录密码或通过 Touch ID 授权管理员权限,等待系统完成文件写入。

2. 运行证书安装脚本(重要步骤)

安装完成后,系统会在“访达”(Finder)中自动弹出一个名为“Python 3.x”的文件夹。在 macOS 下,使用官方安装包安装的 Python 不会自动挂载系统的根证书链,若跳过此步,后续使用 urllib 发送 HTTPS 请求或使用 pip 安装部分依赖时可能会遇到 SSL 证书验证失败报错(例如 CERTIFICATE_VERIFY_FAILED)。

解决方法非常简单:在弹出的文件夹中双击运行 Install Certificates.command,终端将自动启动并下载更新 certifi 证书文件,看到 Process completed 提示后即可关闭该终端窗口。

3. 终端验证安装结果

打开 macOS 的“终端”(Terminal)应用,执行以下命令验证 Python 解释器与 pip 包管理器是否正常链接:

python3 --version
which python3
python3 -m pip --version

示例输出:

Python 3.12.2
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
pip 24.0 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
macOS安装Python的两种方法:官方安装包与Homebrew对比
图 1:官方安装包从下载、图形向导、证书修复到终端校验的操作步骤

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

Homebrew 是 macOS 社区事实上的标准命令行包管理器。对于日常频繁使用终端的开发者而言,通过 Homebrew 安装与维护 Python 可以将解释器与系统的其他开发库(如 OpenSSL、SQLite、XZ 等)纳归统一的管理生态。

1. 确认已配置 Homebrew

若系统中尚未安装 Homebrew,可以在终端中执行其官方安装脚本;若已经安装,建议在执行安装前同步最新的 Formula 元数据:

brew update

2. 执行安装命令

在终端中直接运行以下安装命令:

brew install python

执行该命令后,Homebrew 会自动解析依赖树,下载预编译的二进制 Bottled 包,并在本地链接所需的辅助 C 语言库(如 openssl@3、readline、mpdecimal、ca-certificates 等)。整个过程完全自动化,无需手动干预。

3. 验证安装与环境变量

安装完成后,Homebrew 会自动在对应的 bin 目录中生成软链接。可以通过以下命令查看版本及二进制实体路径:

python3 --version
which python3
brew info python

在配备 Apple Silicon 芯片(M1/M2/M3/M4 系列)的 Mac 上,Homebrew 的主安装前缀为 /opt/homebrew,因此 which python3 输出应形如:

/opt/homebrew/bin/python3

而在早期的 Intel 架构 Mac 上,默认路径则为 /usr/local/bin/python3。

环境变量注意项:若安装完成后执行 which python3 仍显示非 Homebrew 路径,请检查当前 Shell 配置文件(如 ~/.zshrc),确认 Homebrew 路径(/opt/homebrew/bin)已正确置于 PATH 环境变量的前列。
macOS安装Python的两种方法:官方安装包与Homebrew对比
图 2:Homebrew 安装 Python 的软链接分层与依赖管理架构

两种安装方式的核心维度对比

了解两种安装方式的具体操作后,我们需要从底层机制、维护成本以及对后续开发的影响等方面展开对比,以明确二者的边界。

1. 安装路径与文件分布

  • 官方安装包:将所有实体文件写入系统全局框架路径 /Library/Frameworks/Python.framework/Versions/3.x/,同时在 /usr/local/bin/ 创建可执行文件的软链接,并在“应用程序”文件夹放置官方自带的简易集成开发环境 IDLE。
  • Homebrew:在 Apple Silicon 机型上安装至 /opt/homebrew/Cellar/python@3.x/,在 Intel 机型上安装至 /usr/local/Cellar/python@3.x/。软链接分别放在对应架构的 bin 目录下,不会污染 macOS 的 /Library/Frameworks 系统目录。

2. 升级与更新机制

  • 官方安装包:不具备自动静默更新能力。若要升级到新的小版本或主版本(如从 3.11 升级至 3.12),必须重新前往官网下载新安装包并手动覆盖安装。旧版本通常仍会残留在 Versions 目录下。
  • Homebrew:升级极其简单快捷。只需在终端运行 brew update && brew upgrade python,即可自动完成旧版清理与新版替换,非常适合保持开发工具始终处于最新状态。

3. 卸载与清理难度

  • 官方安装包:官方未随包提供一键卸载程序。如果需要彻底卸载,必须手动执行多条 rm -rf 命令,分别删除框架目录、/usr/local/bin 下相关的符号链接以及应用程序中的 Python 图标。对不熟悉文件系统层级的用户来说存在一定门槛。
  • Homebrew:卸载十分简便,运行 brew uninstall python 即可自动删除全部链接与核心包,不会在其他深层目录残留冗余数据。

4. 系统依赖与隔离性

  • 官方安装包:自身高度独立,不与任何第三方包管理体系绑定。它使用的编译配置非常标准,内置了基于 Tkinter 的图形接口库,在进行简单的桌面图形编程或教学实验时体验非常稳定。
  • Homebrew:深度融入 Homebrew 软件生态。当通过 Homebrew 安装依赖 Python 的其他命令行软件(如 ffmpeg、glib、ansible 等)时,系统可以直接复用现有的 Python 环境与依赖库,避免重复安装。
macOS安装Python的两种方法:官方安装包与Homebrew对比
图 3:官方安装包与 Homebrew 在四大核心维度的对比矩阵

如何选择:场景分析与决策建议

两种安装方式并没有绝对的优劣,关键在于使用者的日常工作流与技术背景:

适合选择官方安装包的情况:

  1. 编程初学者与课程学员:如果只是刚开始学习 Python 语法,希望像安装常规 Mac 软件一样点选“下一步”即完成配置,官方包是最稳妥的选择。它自带的 IDLE 编辑器免去了前期繁杂的开发环境挑选过程。
  2. 不想在系统中引入额外包管理体系:如果平时极少使用命令行,也不希望为了一个 Python 额外安装数吉字节的 Xcode Command Line Tools 和 Homebrew 体系,官方包提供了最为纯粹的独立安装体验。

适合选择 Homebrew 的情况:

  1. 常规软件开发者:如果本地已经使用 Homebrew 管理 Git、Node.js、Go、Docker 或各类命令行小工具,将 Python 统一交由 Homebrew 管理能够获得高度统一的更新与维护体验。
  2. 频繁需要更新软件版本:希望定期通过命令同步最新安全更新和小版本更新,不希望每次都重新打开浏览器寻找下载链接。

不可忽视的最佳实践:使用虚拟环境

无论最终选择官方安装包还是 Homebrew 安装基础 Python,都强烈建议在实际项目开发中采用虚拟环境隔离依赖,而不是直接将第三方包安装到全局环境。现代 Python(特别是 3.12 及以上版本)在检测到全局 pip 安装时,通常会给出 externally-managed-environment 警告,这正是为了防止第三方包破坏系统或包管理器本身的依赖链。

在任意项目目录下建立虚拟环境的标准操作如下:

# 创建名为 .venv 的独立虚拟环境
python3 -m venv .venv

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

# 此时安装的第三方库仅作用于当前项目
pip install requests
macOS安装Python的两种方法:官方安装包与Homebrew对比
图 4:macOS Python 选型决策路径与工程环境最佳实践
相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。