macOS下怎么安装Python：pkg安装包与Homebrew方法对比

Dylan

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

原创

详细对比macOS下安装Python的两大主流方案：官方pkg安装包与Homebrew包管理器。深入剖析底层目录分布、版本升级、多版本共存、证书配置及卸载流程，助你选择最适合的Python安装方案。

图 0：macOS 下 Python 两大安装途径整体架构概览

在 macOS 系统上部署 Python 开发环境，最主流的两种途径是前往 Python 官方网站下载 .pkg 安装包，或者通过社区包管理器 Homebrew 执行 brew install python。两者最终都能在终端提供完整的 Python 3 解释器，但在底层安装路径、升级机制、依赖库隔离及系统清理方式上存在根本差异。本文将逐步演示这两种安装方法的具体操作与排错细节，并从六个核心维度进行全面对比，帮助你结合实际开发场景做出合理的选择。

一、macOS 内置 Python 现状与环境认知

很多刚接触 macOS 的开发者容易对系统自带的 Python 产生困惑。在开始安装前，有必要先理清 macOS 系统环境对于 Python 的支持现状与安全边界：

系统自带 Python 2 已彻底废除：自 macOS Monterey 12.3 起，Apple 已经完全移除了预装的 /usr/bin/python（Python 2.7）。在终端直接输入 python 通常会提示找不到命令。
系统自带的 /usr/bin/python3 是开发工具桩（Shim）：当你在未安装任何独立 Python 的新 Mac 上运行 python3 时，macOS 会弹窗提示需要安装 Xcode 命令行开发者工具（Command Line Tools）。即使安装了该工具，这个 Python 也是受系统完整性保护（SIP）管辖的组件，用于支撑系统构建脚本，绝不能也不应直接在其全局环境通过 pip 安装第三方库。
芯片架构与目录映射：自 Apple Silicon（M 系列芯片）推出后，软件运行时的文件路径发生了分化：官方 .pkg 统一写入 /Library/Frameworks；而 Homebrew 在 Apple Silicon 下的默认根目录为 /opt/homebrew，在 Intel 芯片 Mac 下则为 /usr/local。

图 1：macOS Python 运行时目录架构与系统路径映射

二、方式一：官方 .pkg 安装包全流程与关键细节

官方 .pkg 安装包是 Python 软件基金会针对 macOS 专门打包的独立发布物，也是绝大多数初学者首次安装 Python 时的选择。

1. 下载 Universal2 安装包

打开 Safari 或任意浏览器，访问官方网站下载页：https://www.python.org/downloads/macos/。官方为 macOS 提供了通用的 macOS 64-bit universal2 installer。该安装包内置了针对 Apple Silicon（ARM64）与 Intel（x86_64）两套芯片指令集编译的通用二进制文件，无需担心芯片兼容性问题。

2. 执行向导安装

双击下载得到的 .pkg 文件，按照安装器向导依次点击“继续”、“同意许可协议”，输入 macOS 管理员密码完成授权。安装器会自动完成以下工作：

将完整 Python 解释器、标准库和头文件写入 /Library/Frameworks/Python.framework/Versions/3.x/。
在 /usr/local/bin 目录下建立 python3、python3.x、pip3 等可执行文件的符号链接。
在“访达 > 应用程序”中创建对应版本的 Python 文件夹，提供官方的图形化轻量开发环境 IDLE 以及 Python Launcher。
自动向当前用户的 Shell 配置文件（如 ~/.zprofile）中追加 PATH 环境变量配置，确保终端优先加载新安装的版本。

3. 核心必做步骤：运行证书安装脚本

避坑提醒：macOS 上的官方 Python 不再使用 macOS 系统的钥匙串根证书，而是需要单独配置 OpenSSL CA 证书集合。如果不执行此步骤，后续编写网络请求脚本或使用 pip、urllib 时，极易抛出 urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED]> 异常。

安装完成后，打开“访达”，进入“应用程序 > Python 3.x”目录，找到并双击运行 Install Certificates.command 脚本。或者直接在终端中执行以下命令（以 Python 3.12 为例）：

# 运行官方附带的根证书更新脚本
$ /Applications/Python\ 3.12/Install\ Certificates.command

-- Installing certificates to: /Library/Frameworks/Python.framework/Versions/3.12/etc/openssl/certs
-- Certificate installation complete.

4. 终端校验安装结果

重新打开终端窗口（加载新的环境变量），运行以下命令验证解释器版本与路径映射：

$ python3 --version
Python 3.12.2

$ which python3
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3

三、方式二：Homebrew 安装流程与规范操作

Homebrew 是 macOS 上事实上的标准软件包管理器。使用 Homebrew 安装 Python，能将 Python 与系统中的 Git、Node.js、PostgreSQL 等开发工具纳归统一的包管理生命周期。

1. 前置检查与准备

在终端中检查 Homebrew 是否就绪：

$ brew --version
Homebrew 4.2.x

如果未安装 Homebrew，可在终端执行官网安装脚本：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，并按照提示将 brew 路径加入 ~/.zprofile。

2. 执行安装命令

通过 Homebrew 安装 Python 分为两种形式：安装社区维护的当前主线默认版本，或安装特定的旧版本（以实现版本锁死）：

# 方式 A：安装 Homebrew 当前默认的主线 Python 版本
$ brew install python

# 方式 B：安装指定的特定稳定版本（如 3.11）
$ brew install python@3.11

3. 检查软链接与 PATH 解析

在 Apple Silicon 架构下，Homebrew 会将实际文件解压安装至 /opt/homebrew/Cellar/python@3.x/，并自动在 /opt/homebrew/bin/ 建立名为 python3、python3.x 的符号链接。运行以下命令验证路径指向：

$ which python3
/opt/homebrew/bin/python3

$ python3 --version
Python 3.12.3

4. 遵守 PEP 668 规范与虚拟环境建立

现代版本的 Homebrew 在安装 Python 时严格推行了 Python 官方的 PEP 668 规范（标明当前环境为外部管理的外部环境 externally-managed-environment）。此时若直接运行 pip3 install requests，终端会显式拦截并提示报错。

正确的做法是在每个独立的项目根目录下创建隔离的虚拟环境：

# 在当前工程目录生成独立的虚拟环境
$ python3 -m venv .venv

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

# 在激活的环境下安全安装第三方模块
(.venv) $ pip install requests numpy
Successfully installed certifi-2024.2.2 charset-normalizer-3.3.2 idna-3.7 requests-2.31.0 urllib3-2.2.1 numpy-1.26.4

图 2：macOS 安装 Python 两大途径实操步骤与关键节点对比

四、核心维度深度对比（pkg vs Homebrew）

为了帮助读者从系统架构和长期维护的角度理解差异，下面从六个关键技术维度对两种方式进行对比分析：

1. 目录结构与隔离机制

官方 .pkg：严格遵循 Apple 的 Framework 规范，安装在 /Library/Frameworks/Python.framework。其优点在于与 macOS 原生生态结合紧密，但由于写入的是系统级共享目录，多版本卸载时极易残留。

Homebrew：统一放在沙盒化的 Cellar 仓库（/opt/homebrew/Cellar 或 /usr/local/Cellar），通过符号链接对外暴露。文件归属明确，不会与系统的任何自带工具发生路径交叉。

2. 版本升级与维护成本

官方 .pkg：没有内置的自动升级命令行工具。当官方发布了 3.12.3 修复小版本时，用户必须重新打开官网、下载新的 .pkg 并手动执行安装向导覆盖。如果长期不关注官网动态，容易停留在带有已知安全漏洞的旧版本。

Homebrew：具备极强的包生命周期管理能力。日常仅需执行 brew update && brew upgrade python，即可自动拉取最新的稳定补丁版本，维护成本极低。

3. 多版本共存与版本切换

官方 .pkg：支持安装多个版本的 pkg，不同版本会共存在 Versions/3.11 和 Versions/3.12 中。但哪个版本作为全局默认的 python3，取决于安装顺序以及 ~/.zprofile 中的 PATH 变量优先级，手动调整相对琐碎。

Homebrew：支持精准公式管理（如 python@3.10、python@3.11、python@3.12）。由于符号链接完全由 Homebrew 规范管理，你可以精准通过 python3.11 或 brew link --overwrite python@3.11 明确控制当前环境绑定的主版本。

4. SSL 证书信任状态

官方 .pkg：使用的是私有捆绑的 OpenSSL，安装后必须手动执行 Install Certificates.command，否则无法校验公网 HTTPS 站点的 SSL 证书，是新手极易踩中的高发误区。

Homebrew：在安装 Python 公式时，会自动将 ca-certificates 和 openssl@3 作为依赖包拉取并建立绑定，开箱即具备完整的公网根证书校验能力，无需手动执行额外脚本。

5. 包管理与 PEP 668 环境安全

官方 .pkg：对全局 pip install 限制相对宽松。初学者可以直接用 pip 将库装到全局，短时间内看起来很方便，但时间一长极易造成全局 site-packages 依赖版本冲突，甚至破坏已有脚本的正常运行。

Homebrew：默认开启 EXTERNALLY-MANAGED 标记。它从源头上阻止开发者滥用全局 pip，强制推行每个项目使用 venv 虚拟环境的工业级规范，最大程度保障了系统与项目的长期稳定性。

6. 卸载与清理彻底程度

官方 .pkg：macOS 并没有提供类似 Windows 的“添加/删除程序”面板。卸载 pkg 安装的 Python 需要手动以 root 权限删除 Framework 目录、删除应用程序图标，并逐个清理 /usr/local/bin 下的符号链接。

Homebrew：卸载极为干净简单，仅需一行 brew uninstall python（或附带 --force），Homebrew 会自动追踪其创建的所有软链接和文件并一次性清理完毕。

图 3：官方 pkg 与 Homebrew 安装方案核心维度多维评测矩阵

五、选型建议与工程最佳实践

结合上述分析，如何根据自己的实际开发场景进行选择？

建议选择官方 .pkg 安装包的情况：

编程入门与基础语法学习：如果是首次接触编程，电脑上没有配置过开发者工具链，也不希望花费时间学习终端命令与 Homebrew 的安装和代理配置，直接下载 .pkg 是启动成本最低的选择。
需要使用 IDLE 编辑器：官方安装包自带 IDLE，开箱即可提供一个简单的图形交互界面与代码编辑器，非常适合教学课堂和轻量验证。

建议选择 Homebrew 安装的情况：

日常软件工程与全栈开发：如果你已经是一名开发者，日常需要在 Mac 上使用 Git、Node、Docker、Go、MySQL 等工具，将 Python 统一交由 Homebrew 管理能够获得一致的升级和卸载体验。
多项目协同与依赖隔离：需要精确测试不同 Python 版本（如 3.10 与 3.12 兼容性测试），Homebrew 的按版本安装公式（Formula）能够提供规范清晰的共存环境。

图 4：macOS Python 安装选型决策路径与工程规范

工程黄金法则：无论你最终通过 .pkg 还是 Homebrew 安装了 Python，在开展具体业务项目或下载开源代码时，切勿在全局环境下直接运行 pip install。始终养成在项目目录中执行 python3 -m venv .venv 的习惯，通过虚拟环境承载第三方模块依赖，是避免环境崩溃的最有效途径。

六、常见问题与避坑排查

问题 1：安装完成后，在终端运行 python3 仍指向旧版本或报错？

原因：终端尚未重新加载环境变量，或者原有旧路径在 PATH 中的排序优先于新安装路径。

排查与解决：

完全退出终端应用程序并重新打开。
运行 echo $PATH，检查输出的路径排序。如果使用的是 Homebrew，确保 /opt/homebrew/bin（Apple Silicon）位于 /usr/bin 之前。可在 ~/.zprofile 或 ~/.zshrc 中加入：
```
export PATH="/opt/homebrew/bin:$PATH"
```
运行 source ~/.zshrc 使配置立即生效。

问题 2：pip 安装库时提示 error: externally-managed-environment

原因：这是 Homebrew 遵循 PEP 668 规范的保护机制，防止用户将第三方轮子直接写进受包管理器维护的全局 Python 运行库目录中。

正确解决方式：不要使用 --break-system-packages 强行绕过，而应通过虚拟环境安装：

$ python3 -m venv my_env
$ source my_env/bin/activate
(my_env) $ pip install [包名]

如果需要安装像 black、flake8、yt-dlp 这类全局独立 CLI 工具，推荐使用专门的工具隔离运行器 pipx：

$ brew install pipx
$ pipx install black

问题 3：如何彻底卸载官方 pkg 安装的 Python？

如果希望清理官方 pkg 安装的遗留文件并转投 Homebrew，可以按以下顺序在终端执行清理操作（以 Python 3.12 为例）：

# 1. 删除 Python 框架核心文件目录
$ sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12

# 2. 删除应用程序快捷方式
$ sudo rm -rf "/Applications/Python 3.12"

# 3. 删除 /usr/local/bin 下对应的符号链接
$ cd /usr/local/bin && ls -l | grep 3.12 | awk '{print $9}' | xargs sudo rm -f