macOS怎么安装Python3?Homebrew与官方安装包对比

程一诺
程一诺
发布时间:2026-11-18| 6人浏览过
原创

详细介绍在 macOS 上安装 Python3 的两种主流方法:Homebrew 与官方 PKG 安装包。深入对比两者的路径机制、更新方式、PEP 668规范及卸载维护,帮助读者根据使用场景做出最佳选择。

在一台新配置的 Mac 上打开终端,输入 python 或 python3,屏幕上常常会弹出一行 zsh: command not found,或者触发系统弹窗要求下载几吉字节的 Xcode 命令行开发者工具。自 macOS Monterey (12.3) 起,苹果完全移除了系统内置的 Python 2 运行环境,现代 macOS 默认不再提供直接开箱即用的全局 python 命令。对于准备在 Mac 上编写脚本、进行数据处理或开发 Web 项目的读者来说,配置一个干净、稳定的 Python 3 环境是开展一切工作的第一步。

在 macOS 上安装 Python 3,最主流的两种途径分别是:通过命令行包管理器 Homebrew 安装,以及前往 Python 官网下载图形化的 官方安装包(PKG)。这两种方式在安装步骤、系统目录分布、版本升级机制以及对 pip 依赖包的管控上存在显著差异。本文将完整讲解这两种安装方式的具体操作步骤,并从多个实用维度进行深入对比,帮助读者根据自己的实际需求做出清晰的选择。

一、核心认知:macOS 文件系统与两种安装体系

在开始敲击键盘之前,有必要先理清 Python 在 macOS 系统内部是如何安放的。macOS 遵循严格的系统完整性保护(SIP),用户自行安装的软件绝不应该直接混入系统核心目录 /System/Library 或 /usr/bin 中。Homebrew 与官方安装包都严格遵循了这一规范,但它们选择的安置路径和管理逻辑截然不同。

macOS怎么安装Python3?Homebrew与官方安装包对比
图 1:macOS 下 Homebrew 与官方安装包在系统架构层面的主要落盘差异

简单来说:Homebrew 把 Python 视作整个命令行工具链中的一个软件包,与系统其他开源软件紧密协作;而官方安装包把 Python 视作 macOS 的一级框架,包含自带的开发环境与图形工具,不依赖任何第三方包管理器。

二、方法一:使用 Homebrew 安装 Python 3 完整步骤

如果读者平时经常使用终端,或者电脑里已经安装了 Homebrew,那么使用 Brew 安装 Python 是绝大多数开发者的首选,因为它的安装过程无需手动点击网页,升级也能与其他工具同步。

1. 确认系统环境与架构

打开 macOS 的“终端”(Terminal)应用,首先检查当前电脑是否已安装 Xcode 命令行工具。这是编译和安装开源软件的基础依赖:

xcode-select --install

如果系统提示已安装,则可直接跳过;若弹出安装窗口,请按照提示点击“安装”并等待几分钟完成。

2. 执行 Homebrew 安装命令

确认 Homebrew 正常工作后,在终端中输入以下命令:

brew install python

Homebrew 会自动分析 Python 的最新稳定版本(例如 Python 3.12 或 3.13),并自动下载预编译的二进制 Bottle 包,同时自动下载并安装 OpenSSL、Ca-certificates、XZ 等基础依赖。如果需要指定具体版本(如项目需要 Python 3.11),可以运行:

brew install python@3.11

3. 验证安装结果与路径

安装完成后,检查当前终端所识别的 Python 路径与版本信息:

which python3
python3 --version

在基于 Apple Silicon(M1/M2/M3/M4 系列)芯片的 Mac 上,输出路径应为:

/opt/homebrew/bin/python3

而在基于 Intel 处理器的旧款 Mac 上,输出路径为 /usr/local/bin/python3。

macOS怎么安装Python3?Homebrew与官方安装包对比
图 2:通过 Homebrew 安装 Python 3 的完整执行步骤与流转逻辑
重要注意事项:PEP 668 外部管理环境报错

通过 Homebrew 安装 Python 3 后,如果在全局环境中直接执行 pip3 install requests,终端很可能会抛出 error: externally-managed-environment 错误。这是 Python 社区与 Homebrew 为了防止全局 pip 破坏包管理器本身的依赖而引入的保护标准(PEP 668)。正确的做法永远是为每个项目创建独立的虚拟环境:

python3 -m venv my_project_env
source my_project_env/bin/activate
pip install requests

三、方法二:使用 Python 官方安装包(PKG)完整步骤

对于初学者、教学场景,或者需要使用官方自带图形界面(IDLE)的读者,直接使用 Python 官网提供的 .pkg 安装包是最稳妥直观的方式。

1. 下载 Universal2 架构安装包

访问 Python 官方网站的下载页面(python.org/downloads/macos/)。现代版本的 Python 会提供统一的 macOS 64-bit universal2 installer。这种通用格式同时包含了针对 Apple Silicon(arm64)和 Intel(x86_64)的优化指令集,下载后可在任何架构的 Mac 上原生高效运行。

2. 运行图形向导安装

双击下载好的 python-3.x.x-macos11.pkg 文件,启动标准 macOS 安装向导:

  • 一路点击“继续”,并在软件许可协议界面点击“同意”。
  • 在目标卷宗选择时保持默认的系统磁盘即可。
  • 点击“安装”,输入当前 Mac 用户的登录密码或使用 Touch ID 授权完成写入。
macOS怎么安装Python3?Homebrew与官方安装包对比
图 3:使用官方 PKG 安装包安装 Python 3 的完整操作流程

3. 核心必做步骤:导入 SSL 根证书

安装向导执行结束后,Finder 会自动弹出一个位于 /Applications/Python 3.x/ 的文件夹。在这个文件夹中,务必双击运行 Install Certificates.command。

之所以必须执行这一步,是因为官方包自带了独立的 OpenSSL,它默认不会直接读取 macOS 的系统钥匙串证书库。如果不运行该脚本,后续在使用 urllib.request 下载网页或使用 pip 访问 HTTPS 资源时,经常会出现 SSL: CERTIFICATE_VERIFY_FAILED 错误。双击该脚本后,终端会自动调用 certifi 模块更新证书,看到终端打印出 [Process completed] 即代表配置成功。

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

为了让读者一目了然地看到两者的区别,下面围绕开发者最关心的四个维度进行全面对比:

对比维度 Homebrew 安装方式 官方 PKG 安装包方式
安装与上手门槛 需要提前配置好 Homebrew 环境,依赖终端命令操作,无图形界面。 双击安装包即可,完全基于 macOS 原生向导,附带图形化 IDLE 编辑器。
落盘路径与隔离 集中管理在 /opt/homebrew/Cellar 下,符号链接暴露在 /opt/homebrew/bin。 作为标准系统扩展安装在 /Library/Frameworks/Python.framework。
版本升级便捷性 极简。执行 brew upgrade python 即可全自动升级到最新版。 需手动再次前往官网下载新版本的 PKG 安装包覆盖或共存安装。
多版本管理能力 支持通过 brew install python@3.10 等公式安装,但切换默认版本需调整 PATH 变量。 多个大版本(3.10、3.11、3.12)在 Frameworks 目录下天然共存,互不干扰。
第三方包管理规则 严格执行 PEP 668,默认拒绝 pip3 install 全局写入,强烈推荐虚拟环境。 策略相对宽容,允许全局写入用户主目录或直接调用 pip,初学者更易上手但有污染风险。
完全卸载难度 一条命令 brew uninstall python 彻底清除,干净利落。 需手动删除 Framework 目录、应用程序文件夹及 /usr/local/bin 下的相关软链接。

从上面的对比可以清晰看出:Homebrew 更适合有一定终端基础、追求工作流自动化和环境整洁的技术人员;而官方安装包更适合初次接触编程、需要图形化学习环境的新手。

五、选型决策指南与全景总结

面对这两种成熟的安装路线,读者应该如何选择?可以根据以下具体的应用场景与开发需求进行判断:

macOS怎么安装Python3?Homebrew与官方安装包对比
图 4:macOS Python 3 安装方式选型场景指南与综合评估矩阵

六、常见问题排查(FAQ)

1. 终端输入 python 依然提示找不到命令?

很多初学者安装完后直接输入 python,系统依然报错。这是因为为了保证兼容性,无论是 Homebrew 还是官方安装包,安装后的默认命令名称都是 python3 和 pip3,而不是 python。如果希望输入 python 直接调用 Python 3,可以在当前 Shell 的配置文件(例如 ~/.zshrc)中添加一条别名别名:

echo 'alias python="python3"' >> ~/.zshrc
source ~/.zshrc

2. 使用官方包后执行网络脚本报 SSL 错误?

如果运行爬虫或网络请求脚本时提示 urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED]...>,请前往访达中的 /Applications/Python 3.x/,双击运行 Install Certificates.command,或者直接在终端执行:

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

3. 如何彻底卸载官方安装包?

相比于 Homebrew 简单的 brew uninstall python,官方安装包需要依次删除以下三处文件(以 Python 3.12 为例):

sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12
sudo rm -rf "/Applications/Python 3.12"
sudo rm -f /usr/local/bin/python3.12 /usr/local/bin/pip3.12

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

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 算法库。