macOS怎么安装Python？Homebrew与官方pkg安装指南
深入讲解 macOS 系统下安装 Python 3 的两种规范途径：通过 Homebrew 包管理器命令行安装，以及通过 Python 官方 universal2 pkg 安装包进行图形向导安装。包含详细操作步骤、命令输出核验、关键证书修复以及虚拟环境最佳实践。
一、理解两种安装途径的差异与选型
初次在 macOS 上接触 Python 开发时，读者常常困惑于终端中已经存在的 python3 命令与自行安装版本之间的关系。现代 macOS 系统（自 macOS 12.3 Monterey 起已彻底剔除旧版 Python 2.x）仅在安装 Xcode Command Line Tools 后提供一个位于 /usr/bin/python3 的系统级解释器存根。该存根属于系统底层保护区域，受 SIP（系统完整性保护）约束，不应也无法直接用于日常项目的包安装。
为满足日常编程与开发需求，用户应当部署一套独立的 Python 3 运行时。下表与图示直观展示了 Homebrew 与官方 pkg 安装包在技术实现上的区别：
| 对比维度 | 方案一：Homebrew (brew install) | 方案二：官网 pkg 图形安装包 |
|---|---|---|
| 主要适用群体 | 程序员、终端开发者、需要管理丰富开源工具链者 | 初学者、数据处理办公用户、偏好图形向导者 |
| 物理安装路径 (Apple Silicon) | /opt/homebrew/bin/python3 |
/Library/Frameworks/Python.framework/ |
| 物理安装路径 (Intel x86) | /usr/local/bin/python3 |
/Library/Frameworks/Python.framework/ |
| 包升级机制 | 终端命令 brew upgrade python 一键升级 |
重新下载更高版本 pkg 安装包覆盖或共存 |
| SSL 根证书初始化 | 自动链接 Homebrew openssl 根证书体系 | 必须手动双击执行 Install Certificates.command |
| 全局 pip 行为规范 | 启用 PEP 668，默认阻断全局 pip，要求虚拟环境 | 允许全局 pip 安装，但仍推荐使用虚拟环境 |
选型建议：如果你的 Mac 已经安装了 Homebrew，或者未来需要使用 Git、Node.js、PostgreSQL 等一系列开源工具，强烈推荐选择 Homebrew 统一管理；若你刚接触编程，希望尽可能减少命令行复杂配置，官方 pkg 是更直观的起点。
二、方案一：使用 Homebrew 安装 Python 3（推荐）
Homebrew 是 macOS 上事实标准的包管理工具。通过 Homebrew 安装 Python，能够自动解决底层依赖库（例如 OpenSSL、Readline、SQLite 等），并且便于后续随系统统一维护。
步骤 1：确认终端环境与 Homebrew 状态
打开 macOS 自带的“终端”（Terminal）或常用的终端仿真器（如 iTerm2）。输入以下命令核验 Homebrew 是否已经正常就绪：
brew --versionHomebrew 4.2.15
Homebrew/homebrew-core (git revision a1b2c3; last commit 2024-03-20)如果终端提示 command not found: brew，说明当前 Mac 尚未安装 Homebrew。你可以复制以下官方安装脚本并在终端中回车执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装过程会提示输入 Mac 开机密码并安装 Xcode 命令行工具。安装完毕后，根据屏幕末尾提示将 eval "$(/opt/homebrew/bin/brew shellenv)" 添加到你的 ~/.zprofile 中，以确保 brew 命令进入环境变量。
步骤 2：执行 Python 安装命令
在 Homebrew 状态就绪后，执行以下命令同步仓库并安装稳定版 Python 3：
brew update && brew install pythonHomebrew 会自动拉取对应芯片架构（Apple Silicon 对应 arm64，Intel 对应 x86_64）的预编译二进制 Bottle 包，同时自动配置 python3、pip3 以及必要的头文件支持。
步骤 3：验证可执行文件位置与版本
安装完成后，使用 which 与版本查询命令验证终端当前调用的解释器实体：
which python3
python3 --version/opt/homebrew/bin/python3
Python 3.12.3/usr/local/bin/python3
Python 3.12.3如果输出路径显示为 /opt/homebrew/bin/python3（或 Intel 机器上的 /usr/local/bin/python3），说明 Homebrew 版本的 Python 已经具备最高优先级。
现代 Homebrew 维护的 Python 遵循 Python 官方 PEP 668 规范。若在终端直接执行 pip3 install requests，可能会触发 error: externally-managed-environment 拦截警告。这是 Homebrew 为了避免全局第三方包污染系统工具而设置的保护屏障。正规解决方法是为具体项目建立虚拟环境（详见本文第四节），切勿随意使用 --break-system-packages 强行覆盖。
三、方案二：使用官方 pkg 安装包安装
官方 pkg 安装包是 Python 软件基金会为 macOS 平台打包的标准安装程序，采用原生 macOS 风格的图形向导进行交付。
步骤 1：访问官网下载 Universal2 安装包
使用 Safari 或任意浏览器访问 Python 官方发布页：https://www.python.org/downloads/macos/。在页面中找到最新的稳定发行版，下载名称形如 macOS 64-bit universal2 installer 的 .pkg 文件。“universal2”表明该安装包同时打包了 Apple Silicon（arm64）与 Intel（x86_64）两套机器码，能在所有现代 Mac 上原生高效执行。
步骤 2：跟随图形向导完成安装
- 在“访达”（Finder）的“下载”文件夹中双击运行下载完成的
python-3.x.x-macos11.pkg。 - 依次点击“继续”并阅读许可协议，选择“同意”。
- 安装目标位置保持默认磁盘（Macintosh HD），点击“安装”。
- 根据 macOS 提示输入登录密码或轻触 Touch ID 确认授权，等待写入完成。
安装器会将 Python 完整部署在 /Library/Frameworks/Python.framework/Versions/3.x/，同时在 /Applications（应用程序）文件夹下生成包含 IDLE、说明文档和证书脚本的文件夹。
步骤 3：极其重要的步骤——执行证书安装脚本
这是官方 pkg 途径最容易被忽略的关键环节。macOS 版官方 Python 框架内置了私有的 OpenSSL，并不直接信任 macOS 钥匙串里的根证书。如果跳过此步，后续在使用 pip 安装扩展包或在 Python 代码中使用 urllib、requests 访问 HTTPS 链接时，会直接抛出 SSL: CERTIFICATE_VERIFY_FAILED 严重异常。
解决办法：打开访达，进入“应用程序”目录下的 Python 3.x 文件夹，找到名为 Install Certificates.command 的脚本文件，双击运行它。或者直接在终端中粘贴并执行以下命令：
/Applications/Python\ 3.12/Install\ Certificates.command-- Installing certifi...
Collecting certifi
Downloading certifi-2024.2.2-py3-none-any.whl (163 kB)
Installing collected packages: certifi
Successfully installed certifi-2024.2.2
-- Removing old certificate link...
-- Creating symlink to OpenSSL certificate bundle...
-- Setting permissions...
-- Completed successfully!看到 Completed successfully! 提示后，即可关闭弹出的终端窗口，根证书配置即告完成。
步骤 4：确认 Shell 环境变量注入
官方安装程序在安装阶段会自动修改你的用户配置（通常是 ~/.zprofile 或 ~/.zshrc），将框架目录追加至系统的 PATH 前端。完全退出终端应用并重新打开，执行：
which python3
python3 -c "import ssl; print(ssl.OPENSSL_VERSION)"/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
OpenSSL 3.0.13 30 Jan 2024
四、macOS Python 常见问题排查与日常规范
1. 为什么输入 python 提示 command not found？
在默认情况下，终端只识别 python3 而非 python。这是因为早期很多系统底层依赖 Python 2，社区为了安全避免歧义，将 Python 3 解释器命名为 python3。如果你希望在终端敲击 python 时也能唤起 Python 3，可以在 Shell 配置文件中增加别名：
echo "alias python='python3'" >> ~/.zshrc
source ~/.zshrc设置完毕后，在终端输入 python -V 即可正常打印出版本信息。
2. 环境变量未生效或依然指向 /usr/bin/python3？
若执行 which python3 依旧输出系统存根 /usr/bin/python3，说明新安装的路径未正确加入系统的 PATH 环境变量，或者加入的位置位于系统路径之后。可以通过以下命令查看当前的 PATH 解析顺序：
echo $PATH若使用 Homebrew，请确保 ~/.zshrc 中包含：
export PATH="/opt/homebrew/bin:$PATH"保存后执行 source ~/.zshrc 刷新环境即可恢复正常。
3. 核心最佳实践：利用 venv 建立独立工程环境
无论是通过 Homebrew 还是官方 pkg 安装，最稳健的日常开发方式是：永远不要将业务依赖包直接安装到全局 Python 中。每个工程都应当建立轻量的虚拟隔离环境（venv），避免因库版本冲突导致全局运行环境损坏。
创建一个新项目并在其中建立隔离环境的标准操作命令如下：
# 1. 创建并进入项目工程目录
mkdir my_project && cd my_project
# 2. 使用当前的 python3 创建名为 .venv 的虚拟环境
python3 -m venv .venv
# 3. 激活虚拟环境 (zsh/bash)
source .venv/bin/activate
# 4. 此时命令提示符会出现 (.venv) 前缀，验证解释器指向
which python
which pip
# 5. 在隔离环境中安全安装依赖库
pip install requests
# 6. 退出当前虚拟环境
deactivate/Users/username/my_project/.venv/bin/python
/Users/username/my_project/.venv/bin/pip在激活状态下，所有 pip install 下载的模块均保存在当前项目的 .venv/lib/ 目录下，与宿主操作系统的全局环境实现物理隔离，即使删除整个工程目录也不会在 Mac 系统中残留垃圾文件。
五、总结与维护指引
在 macOS 系统中建立 Python 开发环境的核心原则可以归结为两点：“明确路径来源，坚持工程隔离”。
- 针对 Homebrew 安装者：日常不需要手动干预目录，定期执行
brew update && brew upgrade python保持安全补丁更新。当面对 PEP 668 提示时，遵循规范通过python3 -m venv开展项目。 - 针对官方 pkg 安装者：牢记在新版本安装后运行
Install Certificates.command，确保 SSL 证书链正确闭环。 - 系统安全性注意：绝对不要使用
sudo pip去篡改系统根目录下的任何文件，系统自身的/usr/bin/python3应当完整保留给 macOS 内部工具链。
按照上述标准流程完成配置后，你的 Mac 即可拥有一个结构清晰、符合苹果系统规范且长期稳定的 Python 开发运行时。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
