macOS怎么安装Python 3.9:pkg安装包与Homebrew命令对比
系统介绍在macOS上安装Python 3.9的两种核心方法:官方pkg安装包与Homebrew命令行。涵盖详细安装步骤、环境变量配置、系统目录差异及卸载维护对比,助你根据使用场景精准选型。
.pkg 独立安装包,或者通过 macOS 常用包管理工具 Homebrew 运行安装命令。前者为自包含框架、提供图形向导并自带证书初始化工具,适合新手或独立运行特定软件的场景;后者基于终端统一纳管、依赖隔离清晰且便于卸载与版本切换,是开发者常用的方案。本文将完整介绍这两种方式的操作流程,并从路径分布、多版本共存机制及运维成本等维度进行对照分析。
一、使用官方 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 将弹出标准的系统安装器界面。按照向导依次执行:
- 简介与重要信息:点击“继续”,阅读发行版本说明与架构支持提示。
- 软件许可协议:点击“继续”,并在弹窗中选择“同意”。
- 安装位置与类型:保持默认的“为这台电脑上的所有用户安装”,点击“安装”。
- 系统提权:在弹出的系统验证框中输入管理员密码或使用 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
二、使用 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
/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
三、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 并存),各版本独立按需调用。 |
四、选型落地建议与常见问题排查
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 稳定运行的最佳实践。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













