Mac手动下载官方安装包安装Python 3详细步骤

季宁
季宁
发布时间:2026-10-28| 7人浏览过
原创

针对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 架构。

Mac手动下载官方安装包安装Python 3详细步骤
图 1:Mac 架构分类与 universal2 统一分发包对应关系

二、从 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 结尾的安装包。

注意事项:请勿在搜索引擎中点击标有“推广”或第三方软件下载站的链接。非官方打包的 Python 安装程序可能会捆绑杂质组件或篡改系统全局路径。
Mac手动下载官方安装包安装Python 3详细步骤
图 2:Python 官网下载页面的版本筛选与文件格式甄别流程

三、运行 .pkg 安装程序与步骤解析

下载完成后,在访达(Finder)的“下载”文件夹中找到形如 python-3.x.x-macos11.pkg 的安装包,双击启动 macOS 标准安装器。安装过程分为六个主要步骤:

  1. 简介(Introduction):展示当前 Python 次版本的基本特性和系统兼容性说明,点击右下角“继续”。
  2. 重要信息(Read Me):列出该构建版本的技术要求(如支持的最低 macOS 系统版本)以及随安装包附带的组件说明,阅读后点击“继续”。
  3. 许可协议(License):展示 Python 软件基金会(PSF)开源许可。点击“继续”,并在弹出的确认对话框中点击“同意”。
  4. 安装类型(Installation Type):此处系统会显示将占用的磁盘空间大小。保持默认的标准安装位置(主系统磁盘)即可,无需更改。点击“安装”。
  5. 系统密码验证:此时系统会弹出授权窗口,要求输入当前 Mac 用户的登录密码或通过 Touch ID 进行生物识别验证,以赋予安装器向系统框架目录写入文件的权限。
  6. 安装完成与组件目录自动弹出:安装程序耗时约 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 脚本。
Mac手动下载官方安装包安装Python 3详细步骤
图 3:官方安装器在 macOS 系统中建立的 Framework 与指令链接结构

四、安装后的核心配置: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 终端提示符。

Mac手动下载官方安装包安装Python 3详细步骤
图 4:Mac Python 3 安装后四项关键指标验证流程总结

六、常见问题与注意事项

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 即可。

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

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 算法库。