Mac安装Python:官网pkg安装包下载与验证步骤

山海之间
山海之间
发布时间:2026-11-03| 8人浏览过
原创

详细讲解在Mac系统上通过Python官方pkg安装包下载、图形向导安装、SSL证书配置及终端版本路径验证的完整操作指南。

在 macOS 系统上搭建 Python 开发环境时,直接通过 Python 官方网站下载 .pkg 安装包是兼顾系统隔离性、原生芯片架构适配与长期稳定性的标准安装方式。本文以官网发布的通用安装包为例,完整拆解从安装包选型下载、图形向导安装、关键 SSL 根证书注入,到终端环境与包管理器验证的全流程操作。

Mac安装Python:官网pkg安装包下载与验证步骤
图 1:macOS 官方 pkg 安装包部署与验证全流程架构

一、下载前的准备与安装包选型

macOS 操作系统自带有基础工具链的存根命令,但在终端直接输入某些命令可能触发 Xcode 开发者工具的安装提示。为获取最新功能与独立的开发环境,使用官方维护的预编译安装包是最稳妥的选择。

访问 Python 官方网站的 macOS 专属发布页面:https://www.python.org/downloads/macos/。在页面列表中,官方为每个稳定版本(Stable Releases)提供了针对 macOS 的预编译安装包。

安装包类型 架构支持说明 适用 Mac 机型与系统
macOS 64-bit universal2 installer 双架构通用二进制文件(含 ARM64 与 x86_64) Apple Silicon(M1/M2/M3/M4 系列)及 Intel 架构 Mac,推荐 macOS 11 及更新版本
macOS 64-bit intel-only installer 仅包含 x86_64 架构指令(旧版本维护存档) 仅适用于早期未配备自研芯片的 Intel 架构老旧 Mac 机型

对于绝大多数现代 Mac 用户,请直接点击下载 macOS 64-bit universal2 installer 对应的 .pkg 文件。该安装包天然支持 Apple Silicon 原生指令集,无需经过 Rosetta 2 转译,可获得最优性能表现。

二、标准图形安装向导执行步骤

下载完成后,在访达(Finder)的“下载”文件夹中找到形如 python-3.12.x-macos11.pkg 的安装包文件。macOS 的 pkg 是一种基于系统 Installer 框架的标准打包格式,按照以下流程执行安装:

Mac安装Python:官网pkg安装包下载与验证步骤
图 2:Mac 官方 pkg 安装阶段与执行动作分解
  1. 启动安装器:双击下载的 .pkg 文件,系统将弹出“安装 Python”对话框。首先进入“介绍(Introduction)”界面,点击“继续”。
  2. 阅读重要说明与软件许可:进入“重要信息(Read Me)”和“许可(License)”页面。点击“继续”,在弹出的是否同意软件许可协议的提示框中选择“同意”。
  3. 安装类型与磁盘选择:安装程序默认选择主系统磁盘(Macintosh HD),默认安装类型将框架写入系统的标准应用程序与库目录,建议直接点击“安装”保留标准设置。
  4. 管理员身份授权:系统将弹出触控 ID(Touch ID)验证或密码提示框,输入你的 Mac 开机登录密码或轻触指纹传感器,授权安装程序将框架文件与符号链接写入系统受保护目录。
  5. 完成并自动打开应用程序文件夹:安装完成后,安装器会显示“安装成功”。此时访达会自动打开一个名为 /Applications/Python 3.x/ 的窗口,里面包含 IDLE 集成环境、启动器以及配置脚本。

三、核心环节:运行 Install Certificates.command

这是使用官方 pkg 安装包最容易被忽略、却直接决定后续开发能否正常联网的关键一步。许多初学者安装后使用 pip 安装第三方库或编写网络爬虫时,频繁遇到 SSL: CERTIFICATE_VERIFY_FAILED 错误,其根源就在于未执行此步骤。

Mac安装Python:官网pkg安装包下载与验证步骤
图 3:macOS 官方包独立 OpenSSL 与根证书注入机制

macOS 官方 Python 安装包为了保证跨平台代码行为一致,自身捆绑了一套私有构建的 OpenSSL 运行时,并不直接共享 macOS 系统的钥匙串(Keychain)信任证书库。因此,新安装的 Python 解释器在默认状态下没有任何受信任的根 CA 证书。

证书配置操作方式(二选一)

方式 A(图形界面):在刚才自动弹出的 /Applications/Python 3.x/ 文件夹中,找到名为 Install Certificates.command 的文件,直接双击运行。
方式 B(终端命令):如果该窗口已关闭,可打开“终端”(Terminal),粘贴执行对应版本的命令:

zsh — 执行证书注入脚本 Terminal
# 执行证书安装脚本(以 Python 3.12 为例,路径中的空格需使用反斜杠转义) /Applications/Python\ 3.12/Install\ Certificates.command -- 终端输出示例 -- -- installing certifi Collecting certifi Downloading certifi-2024.x.x-py3-none-any.whl ... Installing collected packages: certifi Successfully installed certifi-2024.x.x -- removing any existing complete certificate bundle -- creating symlink to certifi certificate bundle -- setting permissions -- update complete

当终端窗口底部出现 update complete 并显示进程已完成时,说明脚本已成功安装 Mozilla CA 证书链包,并建立了指向 OpenSSL 的符号链接。此时关闭该终端窗口即可。

四、系统目录与环境变量架构理解

为了避免版本混淆,理解官方 pkg 安装后在 macOS 内部的文件分布非常重要。官方安装包严格遵守苹果的文件系统规范,将主体与软链接分布在不同的专用目录中:

Mac安装Python:官网pkg安装包下载与验证步骤
图 4:macOS 目录架构与终端 PATH 环境变量解析机制
  • 核心框架目录(/Library/Frameworks/Python.framework/Versions/3.x/):存放 Python 解释器二进制实体、标准库代码、内置 OpenSSL 与动态链接库。第三方通过 pip 安装的模块存放在其下的 lib/python3.x/site-packages/。
  • 全局命令链接(/usr/local/bin/):安装程序会自动在此目录下创建指向框架实体的软链接,包括 python3、pip3、python3-config 等。
  • 系统保留存根(/usr/bin/python3):苹果系统内置的命令行工具存根(Shim)。由于 macOS 默认将 /usr/local/bin 置于 /usr/bin 之前,系统会优先调用官网安装的新版本。

五、终端验证操作步骤

完成安装与证书配置后,需要通过 macOS 的“终端”(Terminal)对解释器、执行路径、包管理器及网络 SSL 功能逐一检验,确保配置无缝衔接。

1. 检查 Python 解释器版本

按快捷键 Command + 空格 调出聚焦搜索(Spotlight),输入 Terminal 并回车打开终端。输入以下命令:

zsh — 验证解释器版本 Terminal
python3 --version -- 正常输出示例 -- Python 3.12.8

输出的版本号应与刚才下载安装的稳定版一致。若显示为 Python 3.9.x(系统老旧版本),通常是因为当前打开的终端会话还未读取更新的环境变量,完全退出终端后重新打开即可。

2. 确认可执行文件的实际调用路径

使用 which 命令查看当前终端解析到的 python3 所在绝对路径:

zsh — 检查程序路径 Terminal
which python3 -- 正常输出示例 -- /usr/local/bin/python3

若输出为 /usr/local/bin/python3 或直接指向 /Library/Frameworks/Python.framework/...,即代表命令解析正确,未被系统自带的旧存根抢占。

3. 验证 pip 包管理工具

现代 Python 官方包默认集成 pip。在终端中检查 pip 是否可用并隶属于当前安装的 Python 版本:

zsh — 检查 pip3 版本与绑定关系 Terminal
python3 -m pip --version -- 正常输出示例 -- pip 24.2 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)

使用 python3 -m pip 调用比直接输入 pip 更加精确,能确保调用的正是目标 Python 环境内的包管理器,避免多版本混淆。

4. 验证 HTTPS 网络与 SSL 证书链

在终端中通过单行 Python 代码发起一次 HTTPS 连接测试,直接核验第三节中的根证书是否配置成功:

zsh — 验证 SSL 证书访问 Terminal
python3 -c "import urllib.request; resp = urllib.request.urlopen('https://pypi.org'); print('HTTPS连接成功, 响应码:', resp.status)" -- 正常输出示例 -- HTTPS连接成功, 响应码: 200

当输出状态码为 200 且无任何证书告警时,表明 Python 官方包的运行环境已完全就绪,后续使用 pip 下载依赖包或运行网络请求将不会受到阻拦。

六、验证自检与常见问题排查

在安装与验证过程中,如果遇到非预期情况,可参照下方总结的排查决策矩阵快速定位并解决:

Mac安装Python:官网pkg安装包下载与验证步骤
图 5:终端验证流程与常见故障自检速查图

常见排查要点:

  • 为什么输入 python 提示 command not found?
    macOS 官方安装包遵循 PEP 394 规范,仅注册带大版本号的命令 python3 和 pip3,不强行覆盖无版本号的 python。如果习惯直接输入 python,可在用户配置文件 ~/.zshrc 中添加别名:
    zsh — 配置命令别名(可选)~/.zshrc
    echo 'alias python="python3"' >> ~/.zshrc source ~/.zshrc
  • 验证时仍指向 /usr/bin/python3 怎么办?
    说明终端配置的 PATH 搜索顺序被个人配置文件打乱。可检查 ~/.zprofile 或 ~/.zshrc,确保将 /usr/local/bin 放在前面:
    zsh — 优先设定本地路径~/.zprofile
    export PATH="/usr/local/bin:$PATH"
  • 后续如何卸载或更新?
    官网 pkg 安装的应用采用标准框架管理。更新次要小版本(如 3.12.7 升级至 3.12.8)只需直接下载最新 pkg 覆盖安装即可。如需彻底移除某一大版本,只需删除对应版本的 /Library/Frameworks/Python.framework/Versions/3.x/ 文件夹以及 /Applications/Python 3.x/ 目录,并清理 /usr/local/bin/ 中指向该版本的失效软链接。

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

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