macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比

向北走
向北走
发布时间:2026-11-18| 8人浏览过
原创

系统介绍在macOS上安装Python 3.9的两种核心方法:官方pkg安装包与Homebrew命令行。涵盖详细安装步骤、环境变量配置、系统目录差异及卸载维护对比,助你根据使用场景精准选型。

在 macOS 系统上部署特定历史版本 Python 3.9,主要有两条成熟路径:使用官方提供的 .pkg 独立安装包,或者通过 macOS 常用包管理工具 Homebrew 运行安装命令。前者为自包含框架、提供图形向导并自带证书初始化工具,适合新手或独立运行特定软件的场景;后者基于终端统一纳管、依赖隔离清晰且便于卸载与版本切换,是开发者常用的方案。本文将完整介绍这两种方式的操作流程,并从路径分布、多版本共存机制及运维成本等维度进行对照分析。
macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比
图 1:macOS 下 Python 3.9 两种主流安装方式的路径与受众划分

一、使用官方 pkg 安装包安装 Python 3.9

Python 官方网站为 macOS 提供了标准的安装包文件(.pkg 格式)。对于 Python 3.9,官方在 3.9.1 及之后的维护版本中提供了 macOS 64-bit universal2 installer。该安装包同时支持 Intel x86_64 与 Apple Silicon (M1/M2/M3/M4) 原生架构,能够自动根据芯片加载最佳指令集。

1. 获取安装包与启动安装

访问 Python 官方发布归档页面(python.org/downloads/macos/ 或具体对应版本的 release 页面),定位到 Python 3.9.x(例如最终安全修复版本 3.9.13 等),下载名为 python-3.9.xx-macos11.pkg 的 universal2 格式安装程序。

双击下载得到的 .pkg 文件,macOS 将弹出标准的系统安装器界面。按照向导依次执行:

  1. 简介与重要信息:点击“继续”,阅读发行版本说明与架构支持提示。
  2. 软件许可协议:点击“继续”,并在弹窗中选择“同意”。
  3. 安装位置与类型:保持默认的“为这台电脑上的所有用户安装”,点击“安装”。
  4. 系统提权:在弹出的系统验证框中输入管理员密码或使用 Touch ID 完成授权。

2. 运行关键证书初始化脚本

安装完成后,安装程序会在 /Applications/Python 3.9 文件夹中生成一组快捷管理工具。由于 Python 在 macOS 上自带独立的 OpenSSL 运行库,默认不直接共享 macOS 系统的系统信任钥匙串。初次使用时若不更新根证书,后续使用 urllib 或执行部分网络请求时会抛出 SSL: CERTIFICATE_VERIFY_FAILED 错误。

打开访达中的 /Applications/Python 3.9 目录,双击运行 Install Certificates.command 文件。终端将自动弹窗并下载安装最新的 certifi 根证书链,提示完成后即可关闭该终端窗口。

3. 终端验证安装结果

打开系统的“终端”(Terminal)应用,输入以下命令核验二进制版本及软链接指向:

# 检查 Python 3.9 解释器版本
python3.9 --version

# 示例输出:
# Python 3.9.13

# 检查配套包管理器 pip3.9
pip3.9 --version

# 示例输出:
# pip 22.0.4 from /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/pip (python 3.9)

# 查看可执行路径
which python3.9

# 示例输出:
# /usr/local/bin/python3.9
macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比
图 2:官方 pkg 安装包的五步落地过程与文件分布示意图

二、使用 Homebrew 命令安装 Python 3.9

Homebrew 是 macOS 下最普遍的包管理器。在 Homebrew 中,由于 Python 最新主线版本持续更新(例如 3.12 或 3.13 已经成为默认的 python 配方),针对 Python 3.9 这种历史特定版本,官方采用版本化配方(Formula)命名为 python@3.9。

1. 确认基础环境与更新软件仓库

在安装之前,确保你的 Mac 已经安装了 Xcode 命令行开发者工具(Command Line Tools)以及 Homebrew。如果已经就绪,首先更新本地 formula 索引:

# 更新 Homebrew 索引信息
brew update

2. 执行版本化安装命令

在终端中运行以下命令,Homebrew 将自动拉取编译好的 Bottle 预编译包或在本地执行构建:

# 安装指定历史版本 Python 3.9
brew install python@3.9

安装过程中,Homebrew 会自动处理相关的底层依赖库(例如 openssl@3、readline、sqlite 等),并安装在专属的 Cellar 目录下。

3. 理解“keg-only”特性与配置环境变量

安装完成后的终端提示中,会明确输出一段注意事项:python@3.9 is keg-only, which means it was not symlinked into /opt/homebrew(在 Intel Mac 上对应 /usr/local)。

这是 Homebrew 的重要保护机制:为了防止多个不同版本的 Python 互相覆盖全局的 python3 别名,Homebrew 不会将 python@3.9 的二进制软链接自动写入全局 PATH。若想直接在终端中使用 python3.9 命令,必须按需将路径配置到 Shell 环境文件中。

现代 macOS 默认使用 zsh。根据你的芯片架构(Apple Silicon 根目录为 /opt/homebrew,Intel 根目录为 /usr/local),将环境变量追加至 ~/.zshrc 中:

# 对于 Apple Silicon (M系列芯片) Mac:
echo 'export PATH="/opt/homebrew/opt/python@3.9/bin:$PATH"' >> ~/.zshrc

# 对于 Intel 芯片 Mac:
echo 'export PATH="/usr/local/opt/python@3.9/bin:$PATH"' >> ~/.zshrc

# 重新加载配置文件使环境变量立即生效
source ~/.zshrc
提示:如果你不想让 Python 3.9 覆盖其他可能存在的 Python 3 解释器,也可以不将其整个 bin 目录置于 PATH 前列,而是仅为它设定独立别名或在虚拟环境(/opt/homebrew/opt/python@3.9/bin/python3.9 -m venv myenv)中直接指明绝对路径使用。

4. 检验 Homebrew 版 Python 3.9

执行验证命令,确认解释器位置及版本:

# 验证版本
python3.9 --version

# 示例输出:
# Python 3.9.20 (注:Homebrew 会提供 3.9 系列的最新小版本)

# 查看可执行文件真实路径
which python3.9

# 示例输出 (Apple Silicon):
# /opt/homebrew/opt/python@3.9/bin/python3.9
macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比
图 3:Homebrew 的 Keg-only 机制及环境变量按需生效模型

三、pkg 安装包与 Homebrew 命令的核心维度对比

为了帮助读者建立清晰的技术认知,下表从文件路径、依赖处理、卸载操作及版本并存等六大关键指标进行横向对照:

对比维度 官方 PKG 安装包 Homebrew 命令行 (python@3.9)
安装操作形态 图形化引导界面,双击一路“继续”即可完成。对终端操作零要求。 终端一条命令完成自动化拉取,但需配置一次环境变量(zshrc)。
默认安装路径 /Library/Frameworks/Python.framework/Versions/3.9/ /opt/homebrew/opt/python@3.9/(Apple Silicon)或 /usr/local/opt/python@3.9/(Intel)
全局命令接管 会自动覆盖写入 /usr/local/bin/python3 软链接,直接影响全局默认 python3。 Keg-only 隔离模式,默认不生成全局软链接,绝不影响系统或最新版 Python。
依赖与运行时 自包含所有运行库与独立 Tcl/Tk (用于 IDLE 和 tkinter GUI 开发)。 通过 Homebrew 生态统一管理 openssl 等依赖,与系统基础库解耦良好。
卸载清理难度 较高:官方未提供一键卸载脚本,需手动删除 Framework 目录、应用程序图标及 /usr/local/bin 软链接。 极低:直接运行 brew uninstall python@3.9,自动干净清除全部程序文件。
多版本共存体验 多版本共存时,后安装的 pkg 会强制覆盖 /usr/local/bin/python3 指向,容易造成环境混乱。 天生支持多版本并存(如 3.9、3.10、3.11 并存),各版本独立按需调用。
macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比
图 4:两种安装方式的综合特性对照与场景决策指南

四、选型落地建议与常见问题排查

1. 如何彻底卸载官方 pkg 安装的 Python 3.9?

如果你使用的是官方 .pkg 安装包,后续需要彻底清理它,不能像普通 Mac 软件一样直接拖进废纸篓。需要在终端中执行以下手动清理步骤:

# 1. 彻底删除核心 Framework 目录(需管理员提权)
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.9

# 2. 删除“应用程序”目录下的图标文件
sudo rm -rf "/Applications/Python 3.9"

# 3. 清理 /usr/local/bin 下失效的 3.9 软链接
cd /usr/local/bin && ls -l | grep "../../../Library/Frameworks/Python.framework/Versions/3.9" | awk '{print $9}' | xargs rm

而如果你使用的是 Homebrew,只需一行命令即可全自动清理:

brew uninstall python@3.9

2. 输入 python3 依然显示系统版本或找不到命令怎么办?

macOS 终端遵循从前往后的 PATH 查找逻辑。如果输入 python3 提示的是系统版本或者找不到命令,按以下步骤排查:

  • 使用明确版本命令:无论是哪种安装方式,都会生成带版本号的可执行文件名,优先执行 python3.9 而非泛指的 python3。
  • 核对 PATH 变量顺序:在终端运行 echo $PATH。如果是 Homebrew 安装,确认配置的 /opt/homebrew/opt/python@3.9/bin 是否出现在最前面;若未生效,核查是否修改了当前正在使用的 Shell 配置文件(如 ~/.zshrc 或 ~/.bash_profile)并执行了 source。

3. 严格禁止修改或覆盖系统自带的 Python

较新版本的 macOS(如 macOS Monterey、Ventura、Sonoma、Sequoia)已经完全移除了系统自带的 Python 2,但部分系统内置服务仍依赖系统保留的底层运行时环境(位于只读系统宗卷 /usr/bin/ 中)。

在任何情况下,切勿尝试通过关闭 SIP(系统完整性保护)去强行替换 /usr/bin 下的文件。无论选择官方 pkg 还是 Homebrew,安装的所有文件均位于用户与应用层级目录(/Library 或 /opt/homebrew),这正是保护 macOS 稳定运行的最佳实践。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。