macOS怎么安装Python?官网pkg安装包与Homebrew方法对比
详细介绍在macOS系统上安装Python的两种主流方法:Python官方pkg安装包与Homebrew包管理器。对比两者在安装路径、版本升级、虚拟环境管理及日常维护上的差异,并提供详细操作步骤与选型建议。
在 macOS 上安装 Python 主要有两种主流方式:前往 Python 官方网站下载图形化的 .pkg 安装包,或者通过 macOS 开发者常用的包管理器 Homebrew 在终端执行安装。对于刚接触 macOS 的读者来说,这两种方式都能在系统里顺利运行 Python 脚本,但在底层存储路径、版本升级维护、多版本隔离以及是否强制使用虚拟环境等方面,两者的设计逻辑与使用体验有着明显差异。本文将完整介绍这两种安装方法的具体操作步骤、验证方法及环境配置要点,并对关键差异展开深度对比,帮助你结合自身需求选择合适的安装方案。
一、macOS 自带的 Python 环境现状
很多初学者会疑惑:“Mac 电脑出厂时不是已经有 Python 了吗,为什么还要专门安装?”事实并非如此。在早期的 macOS 系统中,苹果确实内置了 Python 2.7,但从 macOS 12.3 Monterey 版本开始,苹果已彻底将内置的 Python 2 从系统中移除。当前新版本的 macOS 默认并没有包含完整的独立 Python 3 运行时。
如果你在全新的 macOS 系统的“终端”(Terminal)中直接输入 python3,系统往往会弹出一个提示框,询问是否安装“Xcode 命令行开发者工具”(Command Line Developer Tools)。如果点击确认,苹果会为你安装一个精简版的 Python 3。然而,这个版本受苹果开发者工具的更新周期限制,版本迭代较为滞后,且主要用于支撑底层编译工具链,并不适合日常的独立开发、依赖安装或学术研究。因此,在 macOS 上自行配置一套纯净、受控的 Python 环境是必经的一步。
二、方法一:通过官网 pkg 安装包安装
访问 Python 官方网站下载图形化的 .pkg 安装包是官方推荐的标准安装途径,也是对绝大多数初学者最为直观的方法。
1. 下载对应架构的安装包
在浏览器中打开 Python 官方网站的 macOS 下载专区(https://www.python.org/downloads/macos/)。官方页面通常会自动高亮适合 macOS 的最新稳定版本,点击下载带有 macOS 64-bit universal2 installer 字样的 .pkg 文件。“universal2”格式意味着该安装包同时内置了适配 Intel x86_64 与 Apple Silicon(M1/M2/M3/M4 系列)芯片的通用二进制代码,能够在各类 Mac 机型上原生运行。
2. 运行安装向导
下载完成后,在“访达”(Finder)的“下载”文件夹中双击运行 .pkg 文件。安装程序会弹出标准的 macOS 软件安装向导窗口:
- 简介与重要信息:点击“继续”。
- 软件许可协议:点击“继续”,在弹出提示中选择“同意”。
- 安装类型与位置:默认会安装到系统主磁盘,点击“安装”。
- 系统鉴权:系统会弹出 Touch ID 指纹确认或要求输入当前 Mac 的开机管理员密码,验证通过后安装器开始解压并部署文件。
等待进度条走完,提示“安装成功”后,可以点击“关闭”并将安装包移至废纸篓。
安装完成后,系统会自动打开“访达”窗口,显示位于“应用程序”目录下的 Python 3.x 文件夹。该文件夹中包含两个以 .command 结尾的脚本文件,其中最关键的是 Install Certificates.command。
双击运行该脚本的原因:与直接使用系统证书库不同,官方 pkg 随附的 Python 拥有自己独立的 OpenSSL 运行库。如果未执行该脚本,后续在使用 pip install 下载第三方库或在代码中使用 urllib.request 访问 HTTPS 链接时,常会遇到 SSL: CERTIFICATE_VERIFY_FAILED(证书验证失败)的报错。双击运行后,终端会自动通过 pip 安装 certifi 模块并建立证书软链,待终端显示 [进程已完成] 即可关闭窗口。
3. 终端验证与默认组件
打开 macOS 的“终端”(按 Command + 空格键,输入 Terminal 后回车),输入以下命令验证 Python 是否已被正确识别:
python3 --version
# 示例输出:Python 3.12.4
which python3
# 示例输出:/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
# 或通过软链解析为:/usr/local/bin/python3
python3 -m pip --version
# 示例输出:pip 24.1.2 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
除了命令行工具外,官网 pkg 安装包还会附带一个名为 IDLE 的轻量图形化代码编辑器。你可以在“启动台”(Launchpad)或“应用程序”中的 Python 文件夹里直接打开它,用来编写简易的 Python 代码或作为教学交互工具使用。
三、方法二:通过 Homebrew 包管理器安装
对于经常使用终端或已经在 Mac 上进行软件开发的读者,通过 Homebrew 包管理器安装 Python 通常更为敏捷高效。Homebrew 能够将软件及其依赖项统一管理,无需手动下载和解压各类安装包。
1. 前置条件:确认 Homebrew 环境
在开始之前,确保你的 Mac 终端已经配置好 Homebrew。在终端输入以下命令检查:
brew --version
# 示例输出:Homebrew 4.3.15
如果返回 command not found: brew,说明尚未安装 Homebrew,需要先在官方站点(brew.sh)复制安装命令并在终端执行安装与环境变量配置。若已安装,建议先同步一下软件源:
brew update
2. 执行安装命令
在终端直接执行以下指令安装当前 Homebrew 维护的最新版 Python:
brew install python
Homebrew 会自动解析 Python 运行所需的各种底层类库(例如 openssl@3、ca-certificates、readline、sqlite 等),并直接下载针对当前系统构建好的预编译二进制包(Bottle)。整个过程在终端自动完成,通常耗时一到两分钟。
若你的项目需要指定特定的旧版本(例如需要 Python 3.11),可以直接通过版本配方安装:
brew install python@3.11
3. 验证安装路径与版本
安装完成后,Homebrew 会自动将执行程序软链接到系统的标准 bin 目录下。在终端中运行验证命令:
python3 --version
# 示例输出:Python 3.12.4
which python3
# Apple Silicon 芯片(M系列)示例输出:/opt/homebrew/bin/python3
# Intel 芯片示例输出:/usr/local/bin/python3
在使用 Homebrew 安装的 Python 中,如果直接在全局执行 pip3 install requests,现代版本的 pip 会输出如下警告并拒绝安装:
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages in this environment, use a virtual environment...
这是 Python 官方的 PEP 668 安全规范。因为 Homebrew 本身也是依赖包管理系统的,若用户随意在全局 site-packages 里用 pip 安装或升级第三方库,极易破坏 Homebrew 所管理的其它软件依赖。官方推荐的标准做法是为每个项目创建独立的虚拟环境(venv):
# 1. 创建虚拟环境目录
python3 -m venv myenv
# 2. 激活虚拟环境
source myenv/bin/activate
# 3. 在虚拟环境中安全安装第三方库
(myenv) pip install requests
四、官网 pkg 与 Homebrew 方法核心差异对比
尽管两种方式最终都能在终端提供 python3 解释器,但在文件结构、生命周期维护及系统集成度上存在根本性的差异。
| 对比维度 | 官网 .pkg 安装包 | Homebrew (brew install) |
|---|---|---|
| 图形界面与附带工具 | 附带 IDLE 简易集成开发环境与 Python Launcher | 无 GUI 工具,仅包含终端 CLI 解释器与标准库 |
| 安装存储主目录 | /Library/Frameworks/Python.framework/Versions/3.x |
/opt/homebrew/Cellar/python@3.x/(Apple Silicon)或 /usr/local/Cellar/(Intel) |
| 命令软链接路径 | /usr/local/bin/python3 |
/opt/homebrew/bin/python3 |
| 版本更新与升级机制 | 需手动前往官网下载新 pkg 覆盖或并存安装,老版本需手动清理 | 一条 brew upgrade python 命令即可自动更新 |
| 卸载清理难度 | 复杂:无官方卸载器,需手动在终端删除 Framework 目录、应用程序图标及全局软链 | 极简:执行 brew uninstall python 即可彻底移除 |
| 全局 pip 限制 | 默认允许直接向全局目录安装库(若不注意易造成版本污染) | 遵循 PEP 668,默认阻断全局 pip 安装,强制使用 venv 隔离 |
| 根证书(SSL)支持 | 需手动运行 Install Certificates.command 初始化 |
自动依赖安装 ca-certificates,开箱即用 |
1. 目录结构与架构设计
官网 pkg 遵循苹果官方倡导的 macOS Framework 规范,安装在 /Library/Frameworks/Python.framework 下。这是一个跨用户可见的系统级框架,内部包含完整的头文件、动态库、文档与命令行可执行文件,具有很高的独立性。但在更新或卸载时,由于缺乏专门的反安装管理器,清理较为繁琐。
Homebrew 则遵循 Unix 包管理的典型设计,将所有编译后的产物放置在独立的 Cellar(酒窖)沙箱目录下,仅通过 bin 目录下的符号链接暴露给系统。这意味着无论是多版本共存还是彻底销毁,都只需要在包管理器的抽象层进行操作,不会在操作系统各处留下散落的文件。
2. 维护成本与更新便捷性
如果你的开发工作需要长期保持 Python 解释器在最新的补丁小版本上,Homebrew 优势十分显著。只需定期运行 brew update && brew upgrade,Python 及所有命令行工具都会一同得到安全更新。相比之下,官网 pkg 在 Python 发布如 3.12.5 或 3.13.0 时,必须由用户自行前往浏览器下载新的 pkg 包运行覆盖,旧版本随着时间推移极易堆积并占用大量系统磁盘空间。
五、选型建议:我该选择哪种方式?
没有绝对优劣的安装方案,只有最匹配当下使用场景的选择。以下是针对不同使用者的决策建议:
选择官网 .pkg 安装包的场景:
- 初学编程与课堂教学:如果你是刚刚接触编程、计算机科学入门的学生,或者只是想偶尔写个十几行的简单数据处理脚本,官网 pkg 无需事先配置包管理器,下载双击即可上手。附带的 IDLE 提供了开箱即用的代码编辑与运行窗口,省去了额外配置 VS Code 或 PyCharm 等复杂 IDE 的认知负担。
- 企业受限电脑环境:在部分企业配发的受控 Mac 电脑上,员工可能缺乏自由在终端配置 Homebrew 的完整权限,但可以申请安装官方签名的 pkg 软件包。
- 依赖系统 Framework 的特定闭源应用:某些特殊的 macOS 原生桌面软件要求系统存在
/Library/Frameworks/Python.framework标准路径,此时官网 pkg 是最稳妥的兼容保障。
选择 Homebrew 安装的场景:
- 软件工程师与项目开发者:日常开发涉及 Git、Node.js、Go、Redis 等一系列工具链,已广泛依赖 Homebrew 进行日常开发环境维护。将 Python 纳入同一套包管理体系能极大降低维护成本。
- 注重系统纯净度与快速卸载:希望保持 macOS 系统目录结构清爽,需要通过命令行高效更新版本、卸载过期版本,避免手动在各系统路径中翻找残留文件。
- 规范化项目开发:认可并习惯 PEP 668 规范,天然使用
venv或poetry、uv等虚拟环境管理工具隔离项目依赖。
总结来说,如果追求直观简便和自带教学界面,选择官网 pkg 安装包能够最快进入学习状态;如果注重终端效率、长期维护便捷度以及现代软件工程的环境隔离规范,Homebrew 则是更为专业且通用的首选方案。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













