macOS下怎么安装Python及验证是否成功

在 macOS 上安装 Python 主要有两种稳妥且常用的路径：一种是通过 Python 官网提供的标准通用安装包（.pkg）进行图形化安装；另一种是借助 macOS 开发者常用的 Homebrew 包管理器通过终端命令快速安装。完成安装后，需要依次通过版本查询、绝对路径核对、pip 工具状态以及交互式解释器测试这四个检查点，才能完整确认 Python 已经正确就绪且环境没有与系统自带工具发生冲突。

一、安装前准备：认识 macOS 中的 Python 现状

许多读者在初次使用 Mac 时，在终端输入 python3 --version 可能会看到一个版本提示，或者弹出一个请求安装“Xcode 命令行开发者工具”的窗口。这里需要明确 macOS 的环境机制：苹果系统从 macOS 12.3 开始彻底移除了过时的系统级 Python 2，而系统当前附带的 /usr/bin/python3 属于 Xcode 命令行开发套件的组成部分，仅用于支持系统工具与开发框架的基础运行。

为了确保日常开发具有独立性、能够使用最新的 Python 特性，同时避免破坏系统自身依赖，严禁直接修改或强行替换系统目录下的 Python。用户应当安装独立的 Python 运行时，将其安置在标准的独立目录中。

二、方法一：通过官方安装包（.pkg）安装

使用 Python 官方网站发布的 macOS 通用安装包（Universal2 格式，同时原生支持 Apple Silicon M系列芯片与 Intel 架构）是官方最推荐的交互式安装方式。

步骤 1：下载安装包

打开浏览器访问 Python 官方发布网站的 macOS 下载专区（python.org/downloads/macos/）。页面会自动识别 macOS 系统，并提供最新的稳定版安装器。请下载名为 macOS 64-bit universal2 installer 的 .pkg 文件。

步骤 2：执行安装向导

下载完成后，双击打开 .pkg 文件。安装向导将引导完成几个常规步骤：

• 在“介绍”和“重要信息”页点击“继续”；
• 阅读许可协议并点击“同意”；
• 选择默认的安装磁盘，点击“安装”并输入 Mac 用户登录密码或通过触控 ID 确认授权；
• 等待文件写入完毕，提示“安装成功”后关闭向导即可。

步骤 3：关键必做——运行证书配置脚本

这是 macOS 官方安装包最容易被新手遗漏的一步。macOS 与 Windows/Linux 不同，系统钥匙串的根证书不直接注入 Python 自带的 OpenSSL 模块。如果跳过此步，后续使用 urllib 抓取网页或使用 pip 下载包时，往往会触发 SSL: CERTIFICATE_VERIFY_FAILED 报错。

安装器会在“访达（Finder）”的“应用程序”中创建一个名为 Python 3.x（x 为具体版本）的文件夹。进入该文件夹，双击运行其中的 Install Certificates.command 脚本。此时终端会自动弹出一个窗口，下载并安装 certifi 证书包，出现 [Process completed] 即表示证书配置成功。

三、方法二：通过 Homebrew 包管理器安装

对于经常使用终端或进行项目开发的用户，Homebrew 是 macOS 上最受推崇的包管理工具。通过 Homebrew 安装 Python，可以极大简化后续升级与依赖库的管理。

步骤 1：确认终端中已具备 Homebrew

按快捷键 Command + 空格 呼出聚焦搜索，输入 Terminal 并回车打开终端。在终端中输入以下命令检查 Homebrew：

brew --version

若能够输出 Homebrew 版本信息，则可以直接进行下一步；若提示 command not found: brew，则需要先在终端中执行 Homebrew 官方安装脚本完成基础安装。

步骤 2：执行 Python 安装命令

在终端中输入以下命令：

brew install python

Homebrew 将自动下载适合当前 macOS 架构（Apple Silicon 或 Intel）的预编译瓶装包（Bottle），并自动安装对应的依赖项及最新的 OpenSSL 和 CA 证书配置。

四、关键步骤：验证 Python 是否安装成功

完成安装后，必须新打开一个终端窗口（让最新的 PATH 环境变量生效），按顺序执行以下四个关键检查。

1. 检查 Python 解释器版本

在终端中执行以下命令：

python3 --version

输出结果应当显示具体的 Python 3 版本号（如 3.11.x、3.12.x 或更高），表明系统成功识别了 python3 可执行文件。

2. 确认可执行文件的真实绝对路径

仅仅看到版本号还不够，我们需要核实该命令调用的到底是不是刚刚安装的 Python，而非系统旧版本：

which python3

如果输出为 /Library/Frameworks/... 或 /opt/homebrew/bin/...，表明当前优先级最高的是新安装的独立环境。如果输出依然是 /usr/bin/python3，说明终端的环境变量 PATH 尚未刷新或新安装路径排在系统路径之后。

3. 检查 pip 包管理工具及其网络关联

Python 的第三方生态严重依赖 pip。检查其是否就绪及是否绑定在正确的 Python 解释器上：

python3 -m pip --version

通过 python3 -m pip 调用可以保证 pip 与当前执行的 python3 绝对绑定，避免系统多版本混淆。

4. 进入与退出交互式解释器（REPL 测试）

在终端中输入 python3 直接进入交互式环境：

python3

此时终端提示符会变为 >>>。输入一条简单的打印指令：

print("Python on macOS is working!")

回车后若正常打印出文字，则表明解释器内核、动态链接库与标准输出均正常工作。随后输入 exit() 或按快捷键 Control + D 退出解释器，返回终端命令提示符。

五、常见问题与注意事项

1. 为什么输入 python 提示 command not found？

在 macOS 现代终端中，执行 python（不带数字3）通常会提示 zsh: command not found: python。这是完全正常的现代规范设计。因为 Python 官方和苹果均淘汰了 Python 2，为避免老脚本产生歧义，系统默认不再提供通配的 python 别名。

处理建议：在所有日常开发、脚本运行与工具调用中，统统显式使用 python3 和 pip3。如果确实习惯输入 python，可以在当前用户的 Shell 配置文件（macOS 默认使用的是 zsh，配置文件为 ~/.zshrc）中添加一行别名映射：

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

2. Homebrew 安装后 pip 报错：“externally-managed-environment”

这是 Python 3.11 之后引入的 PEP 668 保护机制。如果通过 Homebrew 安装了 Python，并在全局直接执行 pip3 install requests，终端会弹出一长串错误，提示“This environment is externally managed”。

这不是安装故障，而是 macOS 与 Homebrew 故意增加的安全护栏，防止用户在全局随意安装第三方包导致依赖版本互相打架，甚至破坏 Homebrew 自身工具链。

标准解决方案：使用 Python 原生虚拟环境 venv：

# 1. 在项目目录下创建专属虚拟环境
python3 -m venv .venv

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

# 3. 在已激活的隔离环境中正常安装第三方包
pip install requests

六、总结

在 macOS 上安装 Python，核心在于“安装独立环境、显式调用 python3、四步完成验证、按项目隔离依赖”。初学者可优先选用官方 .pkg 安装包并运行证书补丁脚本，开发者可直接使用 brew install python。安装后通过 python3 --version 和 which python3 确认版本与路径归属，并在开发时搭配 venv 虚拟环境，即可在 macOS 上建立起干净、稳健且符合现代规范的 Python 开发环境。