macOS怎么安装Python？Homebrew与官方安装包对比

认真发呆

发布时间：2026-11-13| 5人浏览过

原创

详细讲解在macOS上安装Python的两种主流方法：Homebrew与官方PKG安装包。包含完整安装步骤、环境变量配置、底层架构及深度对比，帮助开发者快速选择最适合的安装方案。

在 macOS 上搭建 Python 开发环境主要有两种可靠途径：通过命令行包管理器 Homebrew 安装，或者前往官网下载 .pkg 官方安装包。直接使用系统预装的 Python 存在版本陈旧与权限限制，因此独立安装现代 Python 是开发的标准起点。

一、认识 macOS 上的 Python 环境格局

macOS 系统自带了一套精简的 Python 运行环境（位于 /usr/bin/python3），它是 Xcode 命令行开发者工具的一部分。该版本主要供操作系统内部自动化脚本与 Apple 开发者工具链使用。苹果对系统目录实施了严格的系统完整性保护（SIP），用户无法也不应该直接修改该环境或向其全局安装第三方模块。

为了满足数据分析、Web 开发或脚本编写需求，开发者通常在用户空间独立安装最新版 Python。Homebrew 与官方 PKG 安装包在系统底层存放的位置、依赖链接机制以及升级管理逻辑上存在明显分工。

macOS怎么安装Python？Homebrew与官方安装包对比 — 图 1：macOS 系统自带 Python 与两类独立安装方式的目录层级与管理区别

二、使用 Homebrew 安装 Python

Homebrew 是 macOS 下最主流的命令行软件包管理工具。借助 Homebrew 安装 Python，不仅可以通过一条命令完成部署，还能自动处理诸如 OpenSSL、XZ、SQLite 等底层 C 语言依赖库。

1. 安装准备

打开 macOS 的“终端”（Terminal）应用。在安装 Homebrew 之前，需要确认系统安装了命令行开发者工具：

xcode-select --install

如果尚未安装 Homebrew，可在终端执行其官方安装脚本：

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

安装完成后，对于 Apple Silicon 芯片（M1/M2/M3/M4）机型，根据终端提示将 Homebrew 的二进制目录注入环境变量，通常是在 ~/.zprofile 或 ~/.zshrc 中添加 eval "$(/opt/homebrew/bin/brew shellenv)"。

2. 执行安装与验证

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

brew install python

Homebrew 会下载最新的 Python 稳定版及其运行所需的全部依赖。安装完成后，运行版本和路径检测命令：

python3 --version
which python3

示例输出：

Python 3.12.3
/opt/homebrew/bin/python3

若终端输出的路径以 /opt/homebrew/bin/（Apple Silicon）或 /usr/local/bin/（Intel 架构）开头，表明系统当前调用的已是 Homebrew 维护的独立 Python 环境。

三、使用 Python 官方 PKG 安装包安装

Python 官方网站（python.org）提供了专为 macOS 定制的通用安装包（macOS 64-bit universal2 installer）。该安装包采用苹果标准的向导式安装界面，原生适配 Intel 与 Apple Silicon 双架构处理器。

1. 下载与安装向导

在浏览器中访问 Python 官方下载页面，点击“Download Python 3.x.x”下载最新的 macOS .pkg 文件。
双击下载好的 .pkg 文件启动安装向导。
按照屏幕提示连续点击“继续”，并在软件许可协议界面选择“同意”。
输入 macOS 用户登录密码以授权安装向导将核心框架写入 /Library/Frameworks/Python.framework。

2. 必不可少的后置配置：运行证书更新脚本

与 Linux 或 Windows 安装包不同，macOS 官方包自带的 Python 为了实现环境隔离，并没有默认直接信任系统钥匙串（Keychain）中的根证书。这会导致初次使用 pip 下载包或使用 urllib 请求 HTTPS 链接时，容易出现 SSL: CERTIFICATE_VERIFY_FAILED 错误。

安装向导结束时会自动打开位于“应用程序”下的 Python 文件夹。读者必须双击运行其中的 Install Certificates.command 文件。该脚本会自动下载并配置 certifi 根证书包，完成后终端会输出相关证书安装成功的提示。

四、Homebrew 与官方安装包深度对比

很多初学者在选择安装方式时常常感到犹豫。虽然两者最终都能在终端提供 python3 和 pip3，但它们的设计目的与维护模式存在本质差异。

对比维度	Homebrew 安装	官方 PKG 安装包
安装形式	纯命令行（`brew install python`）	图形化安装向导（双击 `.pkg`）
存放根路径	`/opt/homebrew/Cellar/`（Apple Silicon） `/usr/local/Cellar/`（Intel）	`/Library/Frameworks/Python.framework/`
升级机制	`brew upgrade python` 随包管理器全自动升级	需手动前往官网下载新版本 PKG 并重新安装覆盖
多小版本共存	通过指定配方（如 `python@3.10`、`python@3.11`）管理	天然按版本号分目录存放在 `Versions/` 下
附带工具	仅包含 Python CLI、pip 及运行库（无 IDLE.app）	包含标准 IDLE.app 编辑器及离线帮助文档
C 依赖扩展编译	优秀。依赖的 OpenSSL、readline 等与 Brew 生态无缝打通	标准环境。部分需要复杂底层 C 库编译的轮子可能需要配置路径
彻底卸载难度	简单：一条 `brew uninstall python` 干净移除	偏复杂：需手动删除 Framework 目录、软链接及 Applications 快捷方式

关于 PEP 668 与 “externally-managed-environment” 错误

从 Python 3.11/3.12 开始，现代 Python 全面推行了 PEP 668 规范。当你在 macOS 上尝试直接运行 pip3 install package 时，系统往往会提示 error: externally-managed-environment。这是为了防止用户全局安装的包与 Homebrew 或系统管理的组件发生版本冲突。解决该提示的正确方式并非强行添加 --break-system-packages，而是创建专用的虚拟环境。

五、选择建议：哪种方式适合你？

根据你的开发习惯与工作流，可以参考以下场景作出选择：

适合选择 Homebrew 的场景：
- 你是一名软件开发者，日常工作中频繁使用终端，并且电脑上已经装有 Homebrew；
- 你希望系统中的 Node.js、Git、PostgreSQL、FFmpeg 等工具由统一的包管理器集中维护；
- 后续需要安装较多包含 C 扩展的 Python 科学计算库，依赖底层编译器支持；
- 希望在不需要时能够通过一条命令彻底、干净地清理环境。
适合选择官方 PKG 的场景：
- 初学者或学生，不希望提前了解和配置 Homebrew 这类命令行工具；
- 需要使用官方自带的 IDLE 作为教学或初学轻量编辑器；
- 需要测试特定版本或维护与特定官方 Framework 强绑定的旧项目；
- 希望与全局包管理工具完全解耦，独立运作。

六、安装完成后的关键操作建议

无论选择哪种安装途径，为了保证开发环境的稳定与可复现性，建议在实际项目中遵循以下准则：

1. 使用虚拟环境管理项目依赖

避免直接向全局环境执行 pip install。在项目根目录下创建专用的虚拟环境：

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

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

# 激活后，终端前缀会显示 (.venv)，此时安装包将完全局限在当前项目内
pip install requests

需要退出当前虚拟环境时，只需在终端中执行 deactivate 即可。

2. 检查 Shell 中的环境变量优先级

macOS 默认使用 zsh 作为终端 Shell。如果同时安装了多个 Python（例如同时存在 Homebrew 和官方包），系统会按照 echo $PATH 中的先后顺序确定优先调用哪一个。你可以通过检查 ~/.zshrc 文件中的 export PATH=... 顺序，确保你期望的 Python 路径排在前面。