macOS怎么安装Python？使用pkg安装包或Homebrew的详细指南

一、先弄清现状：macOS 自带的 Python 是怎么回事？

很多刚接触 Mac 的读者在终端输入 python 时，往往会遇到 zsh: command not found: python 报错，或者弹窗提示需要安装 Xcode 命令行开发者工具。要正确安装 Python，首先需要厘清 macOS 系统的自带环境现状：

• Python 2 的彻底退役： 早期的 macOS（如 macOS Catalina 及更早版本）曾内置老旧的 Python 2.7。但从 macOS Monterey 12.3 开始，Apple 已经完全移除了系统自带的 Python 2 运行库。
• Xcode Command Line Tools 的占位桩： 当用户安装了 Xcode 命令行工具后，系统路径 /usr/bin/python3 会出现一个精简的“运行桩”。这个环境主要服务于 macOS 自身的开发构建工具链，不仅版本往往落后于官方最新版，而且受系统完整性保护（SIP）限制，严禁用户直接通过 pip 安装全局模块。
• 正确的做法： 无论是日常学习、数据分析还是工程开发，都应当单独安装一套属于用户层级的独立 Python 3 解释器，完全不与操作系统底层的系统工具混淆。

二、两种安装途径的深度对比与选择建议

官方 pkg 与 Homebrew 并非对立关系，而是针对不同操作习惯与使用场景的最佳工程实践。下面我们从安装路径、升级维护、交互方式等关键维度进行对比：

三、方法一：使用官方 pkg 安装包安装（图文流程）

Python 官方基金会为 macOS 提供了专门优化的通用安装包（Universal2），能够原生适配配备 Apple Silicon 芯片（M1/M2/M3/M4 系列）以及 Intel 芯片的 Mac 电脑。

第 1 步：从官方网站下载安装包

使用 Safari 或任何现代浏览器访问 Python 官方主页下载板块：

• 下载地址：https://www.python.org/downloads/macos/
• 在页面中找到最新的稳定版（Stable Releases），选择 macOS 64-bit universal2 installer 下载 .pkg 文件。

第 2 步：运行图形安装向导

1. 下载完成后，在“访达”（Finder）的“下载”文件夹中双击该 .pkg 文件。
2. 安装程序将弹出“安装 Python”欢迎界面，按提示依次点击“继续”。
3. 阅读并同意软件许可协议，选择安装目标磁盘（通常默认为 Macintosh HD 系统盘）。
4. 点击“安装”，并在弹出的系统安全弹窗中输入当前 Mac 的开机密码或触控 ID 确认授权。
5. 等待安装进度条走完，提示“安装成功”后点击“关闭”，安装包可选择保留或移入废纸篓。

第 3 步：关键步骤！运行 Install Certificates.command

这是官方 pkg 途径最容易被忽略但至关重要的一步。因为 macOS 上的官方 Python 不直接使用系统钥匙串证书，如果不手动执行根证书同步脚本，后续在使用 pip install 下载包或在代码中使用 urllib 访问网络资源时，会频繁触发 SSL: CERTIFICATE_VERIFY_FAILED 报错。

1. 打开“访达”，在左侧边栏进入“应用程序”文件夹。
2. 找到带有当前安装版本号的文件夹（例如 Python 3.12 或 Python 3.13）。
3. 在文件夹内找到名为 Install Certificates.command 的脚本文件，直接双击运行。
4. 系统会自动弹出一个终端窗口，自动安装并更新 certifi 根证书包，当看到提示 [Process completed] 时，直接关闭该终端窗口即可。

第 4 步：验证安装结果

通过“聚焦搜索”（快捷键 Command + 空格）搜索“终端”并打开，依次输入以下命令核实：

$ python3 --version
Python 3.12.7

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

若输出了具体的版本号，且可执行文件路径位于 /Library/Frameworks/Python.framework/ 下，证明官方 pkg 安装已经完全就绪。

四、方法二：使用 Homebrew 命令行安装（图文流程）

Homebrew 是 macOS 上事实标准的包管理器。使用 Homebrew 安装 Python 的最大优势在于能够轻松实现一键升级，且各类 C 语言编译底层库（如 OpenSSL、bzip2、sqlite3 等）会被统一编排管理，极少出现编译依赖缺失。

第 1 步：确认或准备 Homebrew 环境

打开终端，输入以下命令检查 Mac 当前是否已经就绪 Homebrew：

$ brew --version
Homebrew 4.4.2

如果终端提示 command not found: brew，可直接在终端中运行 Homebrew 官方安装脚本进行安装（若受网络环境限制，亦可使用国内各大高校的镜像源脚本）。

第 2 步：执行 Python 安装命令

在终端中执行如下指令，Homebrew 将自动拉取预编译好的二进制文件（Bottle）以及相关依赖项：

$ brew install python

整个过程包含下载、依赖解析、校验签名与软链注入。安装完毕后，终端最后会列出本次安装的软件路径及安装摘要。

第 3 步：确认终端 PATH 环境变量

现代 macOS 默认使用 Zsh 作为交互式 Shell。为了保证终端输入 python3 时能够准确命中 Homebrew 提供的程序，需确认 Homebrew 的路径在系统环境变量中生效：

• Apple Silicon 架构（M系列芯片）： Homebrew 的核心二进制目录位于 /opt/homebrew/bin。
• Intel 架构： Homebrew 的核心二进制目录位于 /usr/local/bin。

通常在最初安装 Homebrew 时，安装脚本已在 ~/.zprofile 或 ~/.zshrc 中写入了环境激活配置：eval "$(/opt/homebrew/bin/brew shellenv)"。如果输入 which python3 没有指向 Homebrew 路径，可手动将该行追加至配置文件并重载终端。

第 4 步：验证与信息查询

$ python3 --version
Python 3.12.7

$ which python3
/opt/homebrew/bin/python3

$ pip3 --version
pip 24.2 from /opt/homebrew/lib/python3.12/site-packages/pip (python 3.12)

五、安装后必做：理解 PEP 668 与虚拟环境最佳实践

在顺利完成 Python 3 的安装后，许多读者会习惯性地在全局执行 pip3 install requests，但在现代 Python（从 Python 3.11/3.12 起）中，终端往往会抛出令人困惑的报错：

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages in this environment, create a venv...

标准工程操作流程：创建与使用 venv

Python 3 自带了无需额外安装的标准库工具 venv。创建与激活虚拟环境的标准化三步操作如下：

1. 第一步：进入项目目录并创建虚拟环境

   # 进入你自己的工程代码目录
   $ cd ~/Desktop/my_project
   
   # 基于系统 Python 3 创建名为 .venv 的隔离环境目录
   $ python3 -m venv .venv

2. 第二步：激活虚拟环境

   # 激活当前项目的虚拟环境
   $ source .venv/bin/activate
   
   # 此时终端提示符前会出现 (.venv) 标识
   (.venv) $ which python
   /Users/username/Desktop/my_project/.venv/bin/python

3. 第三步：在隔离环境中自由安装第三方依赖

   # 在虚拟环境中，pip 安装的包全部安全存放在该项目目录内
   (.venv) $ pip install requests fastapi uvicorn
   
   # 完成工作后，退出当前虚拟环境
   (.venv) $ deactivate
   $

六、macOS Python 常见问题排查指南

1. 终端提示 command not found: python

原因分析： 当前 macOS 已经不再为 python 命令预留默认软链，所有官方工具链统一命名为 python3 和 pip3。

解决办法： 在终端中始终显式输入 python3 和 pip3。如果习惯直接键入 python，可以在当前用户的 ~/.zshrc 文件末尾添加一条别名配置：

# 打开配置文件
$ nano ~/.zshrc

# 在末尾添加别名映射
alias python="python3"
alias pip="pip3"

# 保存退出后立即生效
$ source ~/.zshrc

2. 运行脚本提示 [SSL: CERTIFICATE_VERIFY_FAILED]

原因分析： 仅发生在使用官方 pkg 安装包时，未执行证书写入脚本导致的根证书缺失。

解决办法： 进入“访达” -> “应用程序” -> “Python 3.x” 目录，双击执行 Install Certificates.command，或者直接在终端中运行其内置 Python 脚本完成同步：

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

3. Apple Silicon (M系列芯片) 出现 Bad CPU type 或架构不匹配

原因分析： 如果 Mac 迁移自旧款 Intel Mac，终端可能默认运行在 Rosetta 2 的 x86_64 仿真模式下，导致安装了 ARM64 架构的 Python 无法调用 x86 编译的底层库。

解决办法： 在终端运行 uname -m 确认当前架构：

• 若输出 arm64，表示当前处于 Apple Silicon 原生模式（正确标准模式）；
• 若输出 x86_64，请在访达的“实用工具”中右键终端应用，选择“显示简介”，取消勾选“使用 Rosetta 打开”。

七、总结

在 macOS 上配置 Python 开发环境已经演进得十分成熟。总结而言：

• 希望通过熟悉友好的图形界面直接使用的读者，选择 官方 .pkg 安装包 是最稳妥的途径，安装后切记双击运行一次 Install Certificates.command；
• 习惯终端操作并希望软件生态一站式更新的读者，首选 Homebrew（brew install python），省心省力；
• 在日常开发中，始终坚守 python3 -m venv 虚拟环境隔离，远离向系统全局环境滥装依赖包的习惯，这是在 Mac 上长期保持开发环境清爽、无冲突的核心秘诀。