macOS怎么安装Python 3.9:pkg安装包与Homebrew方式对比

程一诺
程一诺
发布时间:2026-11-14 | 6人浏览过
原创

详细对比macOS安装Python 3.9的两种主流方式:官网pkg安装包与Homebrew。深入解析安装路径、环境变量配置、多版本共存及卸载清理机制,并提供选型建议。

在 macOS 上安装 Python 3.9 主要有两种官方与社区公认的途径:一种是直接从 Python 官方网站下载图形化的 .pkg 安装包运行向导,另一种是通过 macOS 终端包管理器 Homebrew 执行命令安装。两种方式都能在系统内成功部署 Python 3.9,但在安装路径、环境变量挂载机制、多版本隔离以及后续升级卸载方式上存在显著差异。本文直接拆解这两种方式的具体安装流程、底层路径细节与核心差异,帮助你根据自身开发需求选择更合适的方法。

一、官方 .pkg 安装包方式:安装流程与底层机制

官方 .pkg 安装包是 Python 官方为 macOS 用户提供的标准化独立安装程序。它通过标准的 macOS 图形安装向导将 Python 运行时、标准库、pip 以及专用 GUI 工具(如 IDLE)安装到系统框架目录中。

1. 具体安装步骤

  1. 下载安装包:访问 Python 官方网站历史版本发布页(python.org/downloads/macos/),找到 Python 3.9 的最新维护版本(如 3.9.13),下载适用于 macOS 的 64-bit installer 安装包。
  2. 运行安装向导:双击下载完成的 .pkg 文件,按照屏幕提示连续点击“继续”并同意许可协议,输入当前 macOS 用户的登录密码确认写入系统目录。
  3. 执行证书安装(关键步骤):安装完成后,在打开的访达窗口或终端中,运行该版本附带的 Install Certificates.command 脚本。该脚本会为 Python 3.9 部署权威根证书(certifi),避免后续通过 pip 或 urllib 访问 HTTPS 资源时出现 SSL 证书校验失败的问题。
# 示例命令:手动运行证书脚本(若安装向导未自动执行)
/Applications/Python\ 3.9/Install\ Certificates.command

2. 底层目录与路径机制

官方安装包会将完整的运行框架放置在全局系统库目录中:

  • 核心框架主体:/Library/Frameworks/Python.framework/Versions/3.9/
  • 全局可执行软链接:安装程序会自动在 /usr/local/bin 目录下建立指向框架内可执行程序的软链接,包括 python3.9、pip3.9 以及 python3。
  • Shell 环境变量:安装向导通常会自动在当前用户的 ~/.zshrc 或 ~/.bash_profile 文件末尾追加将 /Library/Frameworks/Python.framework/Versions/3.9/bin 置于 PATH 前端的配置语句。
macOS怎么安装Python 3.9:pkg安装包与Homebrew方式对比
图 1:官方 .pkg 安装包工作流与系统文件分布

二、Homebrew 方式:安装流程与包管理机制

Homebrew 是 macOS 上最普及的命令行包管理器。对于 Python 而言,由于 Python 3.9 属于历史维护版本,Homebrew 将其归类为 keg-only 公式,即 python@3.9。这意味着它不会自动覆盖系统全局的 python3,从而保障系统多环境的稳定性。

1. 具体安装步骤

  1. 安装或更新 Homebrew:确保终端已配置 Homebrew,并执行更新获取最新配方库:
    brew update
  2. 安装指定版本:执行如下命令拉取并解压预编译的 bottle 瓶装包:
    brew install python@3.9
  3. 配置环境变量(视需求而定):安装完成后,Homebrew 会明确提示该包为 keg-only。如果希望在任意终端位置直接运行 python3.9,需要将对应的 bin 目录追加到 ~/.zshrc 中。
# 对于 Apple Silicon 芯片(M1/M2/M3/M4 系列):
echo 'export PATH="/opt/homebrew/opt/python@3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

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

2. 底层架构与 Cellar 机制

Homebrew 严格区分芯片架构,不同架构机器的安装前缀完全不同:

  • Apple Silicon 架构(arm64):安装于 /opt/homebrew/Cellar/python@3.9/,并通过 /opt/homebrew/opt/python@3.9/ 提供稳定的符号链接。
  • Intel 架构(x86_64):安装于 /usr/local/Cellar/python@3.9/,符号链接位于 /usr/local/opt/python@3.9/。
macOS怎么安装Python 3.9:pkg安装包与Homebrew方式对比
图 2:Homebrew 安装与路径管理机制

三、核心维度对比:pkg 安装包 vs Homebrew

为了让选择依据更加清晰,我们从安装便捷度、多版本共存方式、卸载维护以及系统依赖四个核心维度进行横向比对。

对比维度 官方 .pkg 安装包 Homebrew (python@3.9)
安装操作门槛 极低。双击图形界面向导,输入管理员密码即可完成。 较低。需提前配置好 Homebrew,并在终端输入命令。
前置依赖环境 零依赖。预编译自包含运行时,无需 Xcode 命令行工具。 依赖 Xcode Command Line Tools(CLT)及 Homebrew 基础环境。
多版本并存机制 系统框架共存。每个小版本独立位于 /Library/Frameworks。 Keg-only 隔离。通过专门的 opt 目录独立维护,互不干扰。
命令行默认覆盖 通常会自动修改 shell 配置,让 python3 指向自身。 严格隔离。默认不建立全局 python3 软链接,需显式配置 PATH。
卸载与清理难度 较繁琐。无内置卸载器,需手动删除 Framework 及对应软链接。 极简单。直接执行 brew uninstall python@3.9 即可干净清理。
macOS怎么安装Python 3.9:pkg安装包与Homebrew方式对比
图 3:pkg 与 Homebrew 多维度特性矩阵对比

常见认知误区澄清

误区一:“安装 Python 3.9 会不会破坏 macOS 系统的自带组件?”

不会。macOS 系统自带的 Python(位于 /usr/bin/python3)受苹果系统的 SIP(系统完整性保护)机制保护,任何第三方安装包都无法写入该受保护目录。无论是 pkg 还是 Homebrew,安装的目标位置都是独立的用户可用空间(/Library/Frameworks 或 /opt/homebrew),完全不会对系统的核心基础库造成污染。

误区二:“为什么安装了 Homebrew 的 python@3.9,在终端敲 python 依然报错 command not found?”

这是设计上的合理行为。因为 python@3.9 在 Homebrew 中声明为 keg-only,Homebrew 刻意没有将其注册到全局默认命令中。如果你需要直接使用,应显式输入完整链接路径,或者在 ~/.zshrc 中加入 PATH,亦或通过虚拟环境直接调用。

四、选型建议与项目隔离最佳实践

选择哪种方式,主要取决于你的开发工作流和对 macOS 环境的管理偏好:

  • 选择官方 .pkg 安装包的场景:电脑尚未配置 Homebrew 且无意折腾终端包管理器;仅用于单个特定学术实验、教材示例或短期轻量运行 Python 3.9;需要开箱即用的官方 IDLE 图形编辑器。
  • 选择 Homebrew 的场景:日常重度依赖终端;系统中需要同时维护 Python 3.8、3.9、3.11 等多个历史与现代版本;对系统目录整洁度有强迫症,希望后续可以通过一条命令彻底卸载。

无论哪种方式,一律采用虚拟环境开发

直接通过全局 pip3.9 install 安装依赖是造成 Python 环境混乱的根源。正确的做法是使用安装好的 Python 3.9 解释器为具体项目创建独立的虚拟环境:

# 1. 确保指定 Python 3.9 解释器创建虚拟环境
# 如果是 pkg 方式:
python3.9 -m venv .venv

# 如果是 Homebrew 方式(未配置全局 PATH 时,可直接使用绝对路径):
/opt/homebrew/opt/python@3.9/bin/python3.9 -m venv .venv

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

# 3. 验证当前环境解释器版本
python --version
# 输出示例:Python 3.9.13

# 4. 在隔离环境中安全安装项目第三方依赖
pip install requests numpy
macOS怎么安装Python 3.9:pkg安装包与Homebrew方式对比
图 4:安装方式决策流程与虚拟环境隔离指南

五、总结

macOS 下安装 Python 3.9 无论是选择官方 .pkg 还是 Homebrew,底层的核心运行机制均是一致的。差异在于生态集成的思路:

  • 如果你追求快速上手、免配置、自包含,官方 .pkg 是最短路径;
  • 如果你重视环境可控性、整机软件规范化管理与未来轻量卸载,Homebrew 的 python@3.9 则是更成熟的工程方案。

无论最终采用哪种方式,始终养成“项目与解释器解耦、使用 venv 维护独立环境”的开发习惯,才是让 macOS 长期保持开发环境清爽稳定的根本所在。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表