macOS怎么安装Python?Homebrew与官方pkg包对比选择

小岛来信
小岛来信
发布时间:2026-10-29| 8人浏览过
原创

详细对比在macOS系统上通过Homebrew与官方pkg安装包安装Python的核心差异、目录架构、配置步骤与选型建议,帮助读者根据开发需求做出合适选择。

在 macOS 上安装 Python 主要有两种官方和社区最推荐的方式:使用 macOS 常见的包管理器 Homebrew,或者从 Python 官方网站下载双击安装的 官方 .pkg 安装包。如果你是一名经常使用终端、需要安装各种开发库和命令行工具的开发者,Homebrew 是更省心、维护更规范的选择;如果你刚开始接触编程、习惯图形界面,或者需要使用随官方安装包附带的 IDLE 编程环境,官方 .pkg 安装包则是门槛最低的直观路径。本文将详细演示这两种安装的具体步骤,并从文件路径、升级维护、证书配置和多版本管理等方面展开对比,帮助你做出合适的选择。

一、方案一:通过 Homebrew 安装 Python

Homebrew 是 macOS 上广泛使用的包管理器。通过 Homebrew 安装 Python,所有的依赖项、链接关系和后续升级都能由统一的命令完成,避免手动下载安装包和繁杂的覆盖安装。

1. 前置准备:安装 Command Line Tools 与 Homebrew

如果你的 Mac 是全新系统,尚未安装任何开发工具,请先打开“终端”(Terminal.app),输入以下命令安装苹果官方的命令行开发工具:

xcode-select --install

系统会弹出安装确认窗口,点击“安装”并等待几分钟完成。接着,检查是否已安装 Homebrew。在终端运行:

brew --version

如果终端提示 command not found: brew,可以通过官方安装脚本进行安装(命令在终端执行):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后,Homebrew 会在终端底部输出两行 echo 和 eval 命令,提示将 brew 添加到你的 Shell 配置文件(如 ~/.zprofile)中,按照终端提示复制执行即可。

2. 执行安装命令

在终端中直接运行以下命令安装最新的稳定版 Python 3:

brew install python

Homebrew 会自动解析 Python 所需的底层库(例如 openssl、readline、sqlite、xz 等),并下载预编译好的 Bottles 二进制包完成解压与符号链接建立。

3. 验证安装结果

安装完成后,检查 Python 的执行路径与版本号:

python3 --version
which python3
终端示例输出
Python 3.12.3
/opt/homebrew/bin/python3

在 Apple Silicon(M1/M2/M3/M4)芯片的 Mac 上,Homebrew 的默认二进制路径为 /opt/homebrew/bin/python3;在旧款 Intel 芯片的 Mac 上,该路径通常为 /usr/local/bin/python3。只要 which python3 指向了 Homebrew 目录,就说明安装和 PATH 检索均已正常生效。

macOS怎么安装Python?Homebrew与官方pkg包对比选择
图 1:通过 Homebrew 安装与配置 Python 的标准执行流程

二、方案二:通过官方 PKG 安装包安装 Python

Python 官方网站(python.org)为 macOS 提供了预打包好的 Universal 2 二进制 .pkg 安装包。该安装包支持 Intel 与 Apple Silicon 芯片原生运行,并自带标准 IDLE 开发环境以及针对 macOS 系统的配置脚本。

1. 下载官方安装包

打开浏览器访问 Python 官方下载页面 https://www.python.org/downloads/macos/。网站通常会自动识别你的操作系统,并直接提供最新稳定版(例如 Python 3.12.x)的 macOS 64-bit universal2 installer 下载按钮。下载后你会得到一个扩展名为 .pkg 的安装器文件。

2. 运行图形向导完成安装

双击打开下载的 .pkg 文件,按照提示点击“继续”、“同意许可协议”,最后点击“安装”并输入 Mac 的管理员密码。安装程序会将 Python 框架解包至 /Library/Frameworks/Python.framework,并在 /usr/local/bin 目录下建立可执行程序的符号链接。

3. 关键步骤:解决 SSL 证书缺失问题(必做)

很多初学者使用官方安装包后,在用 Python 发送 HTTPS 请求或使用 pip 时会遭遇 SSL: CERTIFICATE_VERIFY_FAILED 错误。这是因为官方 macOS 安装包为了系统独立性,自带了专属的 OpenSSL,并且默认不共用 macOS 系统的钥匙串根证书。

安装完成后,系统会自动弹出一个访达(Finder)窗口,路径位于 /Applications/Python 3.x/。请务必双击运行其中的:

Install Certificates.command

双击后会弹出一个终端窗口,自动下载并安装 certifi 证书包。当终端末尾显示 [Process completed] 时,关闭终端窗口即可。如果当时关闭了访达窗口,也可以直接在终端中手动执行该脚本(以 Python 3.12 为例):

/Applications/Python\ 3.12/Install\ Certificates.command

4. 验证官方安装结果与自带工具

重新打开一个新的终端窗口,输入以下命令核查:

python3 --version
which python3
终端示例输出
Python 3.12.3
/usr/local/bin/python3

此外,在你的“应用程序”目录或者启动台中,可以找到 IDLE.app 和 Python Launcher.app。直接打开 IDLE 即可进入交互式 Python Shell 和代码编辑器,非常适合学生、教学课程或免配置环境的即时轻度编程。

macOS怎么安装Python?Homebrew与官方pkg包对比选择
图 2:官方 PKG 安装包标准安装与关键证书初始化步骤

三、深度对比:Homebrew 与官方 PKG 的核心差异

为了让读者更清楚系统内部到底发生了什么,我们将从目录结构、版本维护、GUI 工具和系统权限等维度进行深度剖析。

1. 文件系统目录结构与 PATH 寻址

macOS 系统自带一套受保护的 Python 运行环境(主要供 Xcode 和系统组件调用),切勿直接去修改系统自带路径。Homebrew 与官方 PKG 均将文件放置在安全的用户和第三方区域,但两者的目录逻辑截然不同:

  • Homebrew 结构:在 Apple Silicon 机型上,Python 实际完整文件安装在 /opt/homebrew/Cellar/python@3.x/ 下,并在 /opt/homebrew/bin/ 建立符号链接。在系统的 PATH 环境变量中,/opt/homebrew/bin 通常排在前面,因此终端输入 python3 会优先命中 Homebrew 提供的版本。
  • 官方 PKG 结构:遵循 macOS 标准的 Framework 架构,实际文件安装在全局库目录 /Library/Frameworks/Python.framework/Versions/3.x/。其命令行可执行链接则放置在 /usr/local/bin/ 中,图形应用放置在 /Applications/Python 3.x/。
macOS怎么安装Python?Homebrew与官方pkg包对比选择
图 3:Homebrew 与官方 PKG 在 macOS 底层的文件架构与寻址对比

2. 版本升级与维护便利性

当 Python 推出次版本更新(例如从 3.12.2 升级到 3.12.3)时:

  • Homebrew:只需在终端执行 brew upgrade python。Homebrew 会自动拉取最新包,替换符号链接,并将旧版本的垃圾文件通过 brew cleanup 自动清理,全程无需人工干预目录。
  • 官方 PKG:没有内置的自动升级工具。读者必须重新访问 python.org,下载新的 .pkg 文件重复执行安装,旧版本的小版本文件会被覆盖,但大版本(如 3.11 与 3.12)会在磁盘上共存,占用额外空间。

3. 软件卸载与清理复杂度

如果未来需要彻底移除 Python:

  • Homebrew:一条命令搞定:brew uninstall python,所有可执行文件与软链接会被一并删除,干净利落。
  • 官方 PKG:macOS 的 .pkg 不提供标准的反安装界面。你需要手动删除 /Library/Frameworks/Python.framework/Versions/3.x 文件夹、/Applications/Python 3.x 文件夹,并手动在 /usr/local/bin 中逐一找出指向该 Python 版本的软链接进行清理。

4. 核心维度对比汇总表

对比维度 Homebrew 安装方式 官方 PKG 安装包方式
安装方式 终端一行命令(brew install python) 浏览器下载 .pkg 双击图形向导安装
安装路径 (Apple Silicon) /opt/homebrew/Cellar/python@... /Library/Frameworks/Python.framework
升级机制 极佳,一条 brew upgrade 命令完成 较弱,需手动前往官网重复下载安装
卸载难度 极低,支持 brew uninstall 一键移除 较高,需手动删除 Framework 及对应符号链接
自带工具 仅包含核心 CLI 工具(python3, pip3) 包含 IDLE 图形编辑器及 Python Launcher
SSL 证书状态 Homebrew 自动关联 OpenSSL 根证书 需手动双击运行 Install Certificates.command
依赖管理契合度 完美契合命令行工具链与 C 依赖库 适合单一脚本运行或独立的教学场景

四、选型决策指南:你该怎么选?

综合上述特性,你可以根据自己的实际使用场景直接对号入座:

macOS怎么安装Python?Homebrew与官方pkg包对比选择
图 4:macOS Python 安装方式场景决策指南

五、安装后的核心规则:使用虚拟环境避免污染全局

无论你选择通过 Homebrew 还是官方 PKG 安装,完成 Python 基础配置后,强烈建议不要直接使用 pip3 install 将各种第三方库装入全局环境。自 Python 3.11 及 PEP 668 规范推出后,macOS 上的 Python 环境通常会开启 externally-managed-environment 保护,直接在全局运行 pip 可能会被系统拦截报错。

正确的项目开发方式是使用 Python 自带的 venv 模块为每个项目创建独立的隔离环境:

# 1. 进入你的项目目录
cd ~/my-python-project

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

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

# 4. 在隔离环境中安全安装依赖库
pip install requests pandas

# 5. 退出虚拟环境(开发完毕后)
deactivate

总结:对于大多数在 Mac 上进行代码编写、数据分析或自动化脚本开发的读者,优先推荐使用 Homebrew 安装 Python。它能与后续可能需要用到的各种命令行工具完美配合,维护成本最低。而官方 PKG 安装包则非常适合课堂演示、零基础初学者以及需要自带 IDLE 环境的特定场景。按照上述流程配置并配合虚拟环境使用,你的 Mac 就能拥有一个干净、稳定且易于维护的 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 算法库。