Mac手动下载官方安装包安装Python 3详细步骤
针对Mac平台通过Python官方网站下载.pkg安装包安装Python 3的完整详细步骤教程,涵盖芯片架构确认、安装包下载、向导安装、SSL证书配置、环境变量与终端验证。
通过 Python 官方网站直接下载 macOS 专属的 .pkg 安装包,是获取纯净、稳定且与系统底层解耦的 Python 3 运行环境最标准的方式。本文将依序讲解如何确认芯片架构、获取官方安装程序、执行标准化安装向导、配置根证书与环境变量,并在终端完成完整性验证。
一、确认 Mac 芯片类型与系统架构
在前往 Python 官网下载安装包之前,了解手头 Mac 的硬件芯片类型是确保安装顺利的第一步。目前主流 macOS 设备分为 Apple Silicon(如 M1、M2、M3、M4 系列芯片,基于 ARM64 架构)与较早的 Intel 芯片(基于 x86_64 架构)。
虽然现代 Python 3 官方 macOS 安装包大多采用 universal2 格式(即单个安装包内同时包含 ARM64 与 x86_64 双架构原生二进制,能够自动识别并以最高性能运行),但确认芯片类型有助于后续排查特定 C 扩展库兼容性以及终端架构状态。
查看芯片架构的具体操作
打开 Mac 自带的“终端”(Terminal)应用,输入以下指令并按回车:
uname -m
命令输出说明(示例):
# 若为 Apple Silicon 系列芯片,输出如下:
arm64
# 若为 Intel 系列芯片,输出如下:
x86_64
此外,读者也可以点击屏幕左上角的苹果图标,选择“关于本机”。在弹出的概览面板中,若“芯片”一栏显示为 Apple M 系列,即为 ARM64 架构;若显示为“处理器:Intel Core”,则为 Intel 架构。
二、从 Python 官方网站下载安装包
获取安装包必须始终认准 Python 官方源。在浏览器中访问 Python 官方 macOS 专属发布页面:
https://www.python.org/downloads/macos/
下载版本的选择策略
进入该页面后,你会看到“Python Releases for macOS”列表,页面中主要呈现两类版本:
- Stable Releases(稳定正式版):日常学习、数据分析、Web 开发或生产脚本必须选择该分类下的版本。通常列表顶部的即为最新的稳定次版本(如 Python 3.12.x 或 3.11.x 等)。
- Pre-releases(预览版/测试版):带有 a(Alpha)、b(Beta)或 rc(Release Candidate)标识的版本,仅供核心开发者测试新特性,普通使用者请勿下载。
在对应的稳定版本条目下,找到名称为 “macOS 64-bit universal2 installer” 的链接,点击后浏览器即会开始下载以 .pkg 结尾的安装包。
三、运行 .pkg 安装程序与步骤解析
下载完成后,在访达(Finder)的“下载”文件夹中找到形如 python-3.x.x-macos11.pkg 的安装包,双击启动 macOS 标准安装器。安装过程分为六个主要步骤:
- 简介(Introduction):展示当前 Python 次版本的基本特性和系统兼容性说明,点击右下角“继续”。
- 重要信息(Read Me):列出该构建版本的技术要求(如支持的最低 macOS 系统版本)以及随安装包附带的组件说明,阅读后点击“继续”。
- 许可协议(License):展示 Python 软件基金会(PSF)开源许可。点击“继续”,并在弹出的确认对话框中点击“同意”。
- 安装类型(Installation Type):此处系统会显示将占用的磁盘空间大小。保持默认的标准安装位置(主系统磁盘)即可,无需更改。点击“安装”。
- 系统密码验证:此时系统会弹出授权窗口,要求输入当前 Mac 用户的登录密码或通过 Touch ID 进行生物识别验证,以赋予安装器向系统框架目录写入文件的权限。
- 安装完成与组件目录自动弹出:安装程序耗时约 10 至 30 秒。写入完毕后,安装器会自动弹出一个名为
Python 3.x的访达文件夹窗口,表明核心文件已就绪。
官方安装包在 Mac 中的文件布局
与通过第三方工具编译或分散安装不同,官方 .pkg 安装包遵循 macOS 的系统框架(Framework)规范。理解这些组件被存放在何处,有助于后续管理和排障:
- 核心运行框架:保存在
/Library/Frameworks/Python.framework/Versions/3.x/,包含解释器二进制、标准库、头文件以及 site-packages 第三方模块库。 - 命令行软链接:安装器会在
/usr/local/bin/中自动创建指向上述框架内对应执行文件的符号链接,如python3、pip3、idle3。 - 图形工具与脚本:自动在
/Applications/Python 3.x/放置图形化轻量 IDE(IDLE)以及两个至关重要的.command脚本。
四、安装后的核心配置:SSL 证书与环境变量
许多初学者在安装完安装包后直接打开终端,却在后续使用 urllib 抓取网页或用 pip 下载包时遭遇 SSL: CERTIFICATE_VERIFY_FAILED 错误。这是因为 macOS 版 Python 并不直接使用操作系统的“钥匙串”(Keychain)根证书,而是自带有独立的证书信任库。
关键步骤:运行 Install Certificates.command
请按以下两种方式之一运行官方证书安装脚本:
- 图形界面方式:在安装结束自动弹出的
/Applications/Python 3.x/窗口中,找到名为Install Certificates.command的脚本文件,双击它。系统将自动拉起终端窗口并运行证书下载更新,看到输出中包含update complete即可关闭窗口。 - 命令行方式:若未看到该窗口,可直接在终端中输入对应版本的绝对路径执行:
/Applications/Python\ 3.*/Install\ Certificates.command
检查与确认终端 PATH 环境变量
自 macOS Catalina(10.15)起,系统默认 Shell 为 zsh。通常官方安装包会自动在用户的配置文件(~/.zprofile)中追加将 /Library/Frameworks/Python.framework/Versions/3.x/bin 加入 PATH 的配置语句。
我们可以通过在终端中打印 $PATH 来确认该路径是否已生效:
echo $PATH
正常情况下,输出中应包含 /Library/Frameworks/Python.framework/Versions/3.x/bin 或 /usr/local/bin。
若在终端输入 python3 提示 command not found,可手动将路径写入 ~/.zshrc 文件末尾:
echo 'export PATH="/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
五、终端完整性验证与初次运行
完成上述步骤后,重新启动一个全新的“终端”窗口,依次进行以下三项验证,确保解释器、包管理器与交互式环境均工作正常。
1. 验证 Python 3 解释器版本
python3 --version
终端应返回你刚刚安装的 Python 实际版本号(示例):
Python 3.12.2
2. 验证 pip3 包管理器及其指向
pip3 --version
终端输出示例:
pip 24.0 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
请留意括号末尾标注的路径必须位于 /Library/Frameworks/Python.framework/... 内,这证明 pip3 与刚刚安装的官方 python3 保持严格对齐,而非指向系统残留的旧版本。
3. 进入交互式解释器并执行第一行代码
在终端直接输入 python3 并回车,进入 Python 交互提示符(>>>):
python3
Python 3.12.2 (v3.12.2:6abddd9f6a, Feb 6 2024, 17:02:06) [Clang 13.0.0 (clang-1300.0.29.30)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello, Mac and Python 3!")
Hello, Mac and Python 3!
>>> exit()
打印出预期文字后,输入 exit() 或按下快捷键 Control + D 即可安全退出交互环境并返回 macOS 终端提示符。
六、常见问题与注意事项
1. 为什么在终端输入 python 依然找不到或报错?
在 macOS 系统中,历史上曾内嵌过 Python 2.7(命令为 python),苹果自 macOS 12.3 起已将其从系统中彻底移除。官方安装包为了不污染或混淆系统行为,默认只注册 python3 和 pip3 命令。
如果你希望在日常输入时省略“3”,可在 ~/.zshrc 中添加 alias 别名:
echo 'alias python="python3"' >> ~/.zshrc
echo 'alias pip="pip3"' >> ~/.zshrc
source ~/.zshrc
2. 双击打开 .pkg 提示“无法打开,因为无法验证开发者”怎么办?
虽然 Python 官方安装包拥有苹果官方签发的公证(Notarization)证书,但在某些 macOS 安全策略(如 Gatekeeper 设置较为严格)的设备上,可能会拦截初次打开的安装包。此时切勿随意在网上下载工具,正确做法是:
- 按住键盘上的
Control键不放,鼠标右键点击.pkg文件,在弹出菜单中选择“打开”。 - 在弹出的对话框中,系统会提供明确的“打开”选项,点击即可放行。
- 或者进入 Mac 的“系统设置” -> “隐私与安全性”,下拉到底部“安全性”区域,点击“仍要打开”。
3. 日常开发中的依赖包隔离建议
通过官方安装包安装的 Python 为全局环境。在日常项目中,强烈建议不要随意使用 sudo pip3 install 直接污染全局 site-packages。对于独立项目,推荐利用 Python 3 自带的 venv 模块创建虚拟环境:
# 创建名为 myproject_env 的隔离环境
python3 -m venv myproject_env
# 激活虚拟环境
source myproject_env/bin/activate
# 此时安装的第三方库均限制在当前环境内
pip install requests
需要退出虚拟环境时,直接在终端输入 deactivate 即可。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













