macOS系统怎么下载并安装Python开发环境

在 macOS 系统上配置 Python 开发环境，最可靠的路径分为两部分：先通过官方安装包（或 Homebrew 包管理器）在系统全局部署受支持的 Python 运行时，再为具体项目建立相互隔离的虚拟环境（venv）。本文将详细介绍两种主流安装方式的完整步骤、关键配置项、证书修复方法以及验证流程，帮助读者在 Mac 上建立干净、稳定的开发基础。

一、安装前的两个常见认知误区

在开始下载之前，有两个关于 macOS 与 Python 的常见说法容易引起混淆，需要先明确其背后的实际机制：

• 误区一：“macOS 自带 Python，因此不需要额外安装”
  早期的 macOS 版本确实曾内置过 Python 2.7，但苹果已经在 macOS 12.3（Monterey）中彻底将其移除。虽然在安装 Xcode 命令行工具后，终端中可能会存在位于 /usr/bin/python3 的精简运行时，但它属于系统开发工具链的附属组件，缺少第三方库管理权限与独立更新能力，直接在系统层级修改会导致依赖混乱。因此，进行日常开发必须单独下载和安装独立的 Python 版本。
• 误区二：“安装完成后，终端输入 python 就能直接使用”
  在主流的 macOS 终端环境（默认使用 zsh）中，直接输入 python 通常会提示 command not found。这是因为官方安装包遵循 PEP 规范，为了防止与潜在的历史脚本产生命名冲突，默认注册的命令名称为 python3 和 pip3。

二、方法一：通过官网安装包安装（官方标准途径）

官方安装包由 Python 核心团队维护，以标准的 .pkg 文件格式分发，提供了最原生的开发组件与文档，也是多数初学者和独立开发者的首选。

1. 下载安装包

打开 Mac 上的 Safari 或其他浏览器，访问 Python 官方网站的 macOS 专属下载页面：

https://www.python.org/downloads/macos/

在页面上方找到“Latest Python 3 Release”或稳定版本列表，选择 macOS 64-bit universal2 installer 下载。该通用二进制安装包同时内建了适用于 Apple Silicon（M1/M2/M3/M4 系列芯片）与 Intel 处理器的原生可执行文件，无论你的 Mac 是何种芯片均可直接运行。

2. 运行安装向导

1. 下载完成后，在“下载”文件夹中双击打开 python-3.x.x-macos11.pkg 文件。
2. 在弹出的安装窗口中，依次点击“继续”、“继续”，并阅读软件许可协议后点击“同意”。
3. 在“安装类型”界面保持默认设置，点击“安装”，系统会提示输入 Mac 的开机密码或触控 ID 授权。
4. 等待进度条走完，提示“安装成功”后，关闭安装器并可选择将安装包移至废纸篓。

3. 关键后置步骤：运行证书安装脚本

这是绝大多数官方包初学者容易遗漏的关键步骤。macOS 官方包自带了私有编译的 OpenSSL，并不默认读取 macOS 系统的钥匙串根证书。如果忽略此步，在使用 pip install 或 Python 的 urllib 抓取网络数据时，会直接抛出 SSL: CERTIFICATE_VERIFY_FAILED 错误。

安装完成后，系统会自动打开“访达”窗口（路径为 /Applications/Python 3.x/）。在窗口中找到名为 Install Certificates.command 的文件，直接双击运行它。终端窗口会自动弹起并下载 certifi 证书文件，看到输出 Updating certificates in ... successfully 即可关闭窗口。

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

如果你的 Mac 上已经配置了 Homebrew（macOS 最通用的第三方包管理工具），也可以直接通过命令行完成下载与配置。

打开“终端”（Terminal）应用，输入以下命令更新源并安装 Python：

brew update
brew install python

Homebrew 会自动解析依赖并下载预编译好的二进制文件（Bottle）。在 Apple Silicon 机型上，Python 会被链接到 /opt/homebrew/bin/python3；在 Intel 机型上则链接到 /usr/local/bin/python3。Homebrew 的优势在于后续可以通过 brew upgrade python 便捷升级，且它默认集成了系统的 CA 证书。

四、环境验证与路径解析

无论选择哪种方式安装，完成之后都必须在终端中进行输出验证，确认命令能够被正确识别并且路径指向预期的运行时。

1. 检查 Python 与 pip 版本

在终端中依次执行以下两条命令：

python3 --version
pip3 --version

2. 检查可执行文件的具体路径

执行 which 命令确认当前终端调用的是否为你刚刚安装的 Python：

which python3

五、搭建隔离的开发环境：使用 venv

只完成全局安装并不等同于拥有了健壮的开发环境。直接使用 pip3 install package 向全局环境堆砌类库，很快会遇到不同项目依赖版本冲突的问题（甚至会触发 macOS 系统的外部环境托管保护报错 error: externally-managed-environment）。现代 Python 开发的规范做法是：每个项目拥有独立的虚拟环境。

1. 创建项目目录并初始化虚拟环境

打开终端，进入你的工作目录，创建一个演示项目并初始化环境：

# 创建并进入项目目录
mkdir ~/Desktop/my_project
cd ~/Desktop/my_project

# 使用标准模块 venv 创建名为 .venv 的虚拟环境
python3 -m venv .venv

执行该命令后，当前目录下会生成一个名为 .venv 的隐藏文件夹，里面包含了一套独立的 Python 解释器替身和独立的 site-packages 目录。

2. 激活虚拟环境

在终端中输入激活脚本路径：

source .venv/bin/activate

激活成功后，终端提示符最左侧会出现括号包裹的环境名，例如 (.venv) user@MacBook my_project %。此时，环境变量中的 PATH 已被临时重定向到该虚拟环境内部。

3. 在虚拟环境中安装与管理依赖

在虚拟环境处于激活状态下，直接使用 python 和 pip 即可，无需再带数字后缀：

# 检查当前环境中的 Python 指向
which python

# 安装项目所需的第三方库（例如 requests）
pip install requests

# 导出当前项目的依赖清单
pip freeze > requirements.txt

4. 退出虚拟环境

当你完成当前项目的开发工作，需要切换到其他项目或返回全局环境时，直接输入：

deactivate

终端提示符前面的 (.venv) 消失，环境恢复到默认状态。

六、安装后常见问题与排查

1. 终端提示 command not found: python

原因：macOS 默认仅注册了 python3 命令。如果你希望在终端中输入 python 也能直接调用，可以在用户配置文件中添加别名。

做法：在终端中编辑 ~/.zshrc 文件（如果使用 bash 则是 ~/.bash_profile）：

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

配置后再次输入 python --version 即可正常响应。

2. 运行 Python 代码访问 HTTPS 时抛出 SSL 证书异常

现象：报错提示 urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate>。

解决办法：若在安装时跳过了证书脚本，可以在终端中直接执行对应版本的修复命令（以 Python 3.12 为例）：

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

该脚本会自动从 PyPI 获取最新的权威根证书列表并链接至 Python 运行时目录。