macOS系统下载和安装Python的详细步骤
详细介绍在 macOS 系统中下载与安装 Python 的完整实操步骤。涵盖 Apple Silicon 与 Intel 芯片架构确认、官方 pkg 安装包下载向导、SSL 证书配置、环境变量与 alias 别名设置、Homebrew 替代方案及环境验证排错。
在 macOS 系统上配置 Python 开发环境的核心任务,是获取独立于操作系统的完整 Python 3 运行时,并保证命令行工具能准确识别。由于 macOS 系统底层依赖部分特定的脚本工具,直接修改系统默认文件存在安全风险。目前最稳妥、规范的做法是从 Python 官方网站下载专为 macOS 编译的 Universal2 安装包进行图形化安装,随后运行证书修复脚本并核验终端环境。本文将从架构确认、安装包下载、逐步安装、证书与终端配置、以及验证排错五个方面展开完整步骤。
一、安装前的准备与系统架构确认
在下载安装包之前,了解当前 Mac 电脑的芯片架构能够帮助我们确认安装包的兼容性。目前常见的 Mac 电脑分为两类处理器:一类是搭载 Apple Silicon(M1、M2、M3、M4 及其衍生芯片)的机型,另一类是较早期的 Intel 处理器机型。
你可以通过打开 macOS 自带的“终端”(Terminal)应用程序,输入以下命令来查看当前系统的硬件架构:
uname -m
终端给出的示例输出如下:
# 若输出 arm64,表示当前机型为 Apple Silicon 芯片(M系列):
arm64
# 若输出 x86_64,表示当前机型为 Intel 芯片:
x86_64
明确芯片架构后无需担忧选错文件,因为现代官方 Python 发布包采用了 Universal2(通用二进制)格式,一份安装包内部同时封装了适用于 arm64 与 x86_64 两套指令集的原生二进制文件。无论哪种芯片,系统安装器都会自动解压并匹配当前硬件的最佳执行效率。
部分 macOS 系统在安装 Xcode Command Line Tools 后,会在 /usr/bin/python3 放置系统自带的精简运行时。该运行时缺失完整的开发组件,且受 macOS 系统完整性保护(SIP)锁定。我们的目标是安装独立的用户级 Python,让官方框架与系统环境并行共存,互不干扰。
二、官方安装包(pkg)下载与安装详细步骤
使用官方提供的 .pkg 安装包是官方推荐的标准安装途径。它会将 Python 部署在专用的系统框架目录中,并自动建立日常所需的命令行软链接。
使用 Safari 或任意浏览器访问 Python 官方发布网站的 macOS 专属页面(网址为 https://www.python.org/downloads/macos/)。
在页面顶部的“Latest Python 3 Release”区域,找到当前最新的稳定版本(例如 Python 3.12.x 或 3.13.x),在下载文件列表(Files)中点击下载名称为 macOS 64-bit universal2 installer 的 .pkg 文件。
下载完成后,前往“下载”(Downloads)文件夹,双击打开刚下载的 .pkg 文件。系统将弹出标准的 macOS 软件安装向导窗口:
- 简介与重要信息:点击右下角的“继续”按钮,查阅版本包含的新特性与变更。
- 软件许可协议:继续点击“继续”,并在弹出的确认对话框中点击“同意”(Agree)以接受开源许可。
- 安装类型与位置:向导默认将软件安装至主系统磁盘(Macintosh HD),保持默认设置即可,无需更改安装路径。
在安装类型界面点击“安装”(Install)按钮。此时 macOS 系统会弹出安全认证弹窗,提示“安装器正在尝试安装新软件”。请输入当前 Mac 用户账户的开机密码,或通过触控 ID(Touch ID)指纹完成授权。
向导将把运行时文件拷贝至 /Library/Frameworks/Python.framework 目录,并在 /usr/local/bin 目录下建立可执行文件软链接。写入完成后,向导会显示“安装成功”。
安装完成后,系统会自动打开“访达”窗口,定位至 /Applications/Python 3.x(应用程序下的 Python 专属文件夹)。这一步至关重要,很多初学者忽略了此步骤导致后续无法下载第三方模块。
请在打开的文件夹中找到名为 Install Certificates.command 的脚本文件,鼠标双击运行它。此时系统会自动弹出一个终端窗口,利用附带的 certifi 模块自动提取并配置系统的 Mozilla 根证书文件。
终端窗口最后若出现类似以下内容,即表示配置成功,随后可关闭该终端窗口:
-- installing certifi
-- removing any existing certificate link
-- creating symlink to certifi certificate bundle
[Process completed]
三、使用终端验证与配置环境变量
完成上述安装后,我们需要在 macOS 终端中检查新 Python 是否已经被系统检索路径正确定位。
1. 检验 Python 与 Pip 版本
按快捷键 Command + 空格 唤出聚焦搜索(Spotlight),输入“终端”或“Terminal”并回车打开终端。依次执行以下两行检查命令:
python3 --version
pip3 --version
终端输出示例:
# 正确输出所安装的版本号,例如:
Python 3.12.3
# 正确输出 pip 版本及其所在框架路径:
pip 24.0 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
同时,可以使用 which 命令确认命令的实际执行程序来源:
which python3
# 官方安装包默认映射的标准路径示例:
/usr/local/bin/python3
2. 为什么是 python3 而非 python?
在 macOS 乃至现代 Linux 规范中,为了避免与早期 Python 2 的遗留脚本产生混淆,所有 Python 3 的可执行程序均以 python3 和 pip3 命名。如果在终端中直接输入 python,通常会返回 zsh: command not found: python。
3. 配置别名(Alias):让 python 命令等同于 python3
如果你希望在终端中输入简短的 python 也能直接进入当前安装的 Python 3 交互环境,可以通过配置当前用户的 Shell 配置文件来实现。自 macOS Catalina(10.15)起,系统的默认 Shell 为 zsh,其配置文件为用户根目录下的 ~/.zshrc。
在终端中执行以下两条命令:
# 1. 向 ~/.zshrc 文件末尾追加别名配置
echo 'alias python="python3"' >> ~/.zshrc
# 2. 立即重载配置文件使设置生效
source ~/.zshrc
配置完成后,再次在终端中输入 python --version,就会直接显示 Python 3 的版本号,兼顾了输入便利与底层规范。
四、进阶与替代方案:通过 Homebrew 管理 Python
如果平时频繁使用终端,或者已经安装了 macOS 的包管理器 Homebrew,那么通过命令行管理 Python 也是一个高效的选择。
1. Homebrew 安装命令
在终端中直接运行以下命令即可完成安装:
# 更新软件仓库索引并安装最新版 Python
brew update
brew install python
2. 路径区别与多架构存放规则
Homebrew 会自动为命令配置环境路径,但其安装目录与官方安装包不同:
| 安装方式 | Apple Silicon (M系列) 路径 | Intel (x86_64) 路径 | 特点 |
|---|---|---|---|
| 官方 .pkg 安装包 | /Library/Frameworks/Python.framework/软链接至 /usr/local/bin/python3 |
自带图形化 IDLE,官方独立框架,适合所有初学者与通用场景。 | |
| Homebrew 安装 | /opt/homebrew/bin/python3 |
/usr/local/bin/python3 |
通过命令行升级与卸载极其方便,适合常用命令行开发的人群。 |
3. 现代 Python 的虚拟环境规范(venv)
随着现代 Python 打包标准(PEP 668)的推行,macOS 上无论通过哪种方式安装的 Python,直接向全局运行 pip3 install [包名] 时都可能会遇到 error: externally-managed-environment 提示。这是为了防止不同项目所需的包版本产生冲突。
在实际编写具体项目时,推荐养成在项目目录中建立虚拟环境的习惯:
# 1. 新建并进入工程目录
mkdir my_project && cd my_project
# 2. 创建名为 .venv 的本地虚拟环境
python3 -m venv .venv
# 3. 激活虚拟环境
source .venv/bin/activate
# 4. 此时命令提示符前会出现 (.venv),可放心安装所需模块
pip install requests
五、常见问题排查与安装后自查清单
为了确认整个安装流程万无一失,我们可以对照以下 4 个关键维度进行快速验证:
常见问题一:网络请求报错 SSL: CERTIFICATE_VERIFY_FAILED
表现:在运行 Python 脚本进行网络爬虫、调用第三方 API 或通过某些工具下载依赖时,出现 urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate>。
原因与修复:macOS 版的官方 Python 不再使用 macOS 系统的 Keychain 证书库,而是自带独立的 OpenSSL,若未注入根证书则无法校验 HTTPS 请求。只需打开访达,进入“应用程序”中的 Python 3.x 目录,再次双击运行 Install Certificates.command,脚本完成后该问题即彻底解决。
常见问题二:关闭终端后设置的 alias 别名失效
表现:刚才配置的 python 命令有效,但在重新打开一个新的终端窗口后,又提示 command not found。
原因与修复:如果直接在终端中敲 alias python="python3",别名只存在于当前临时会话中。必须将其永久写入 ~/.zshrc 文件(如果使用的是 bash 则为 ~/.bash_profile),并执行 source ~/.zshrc 保存。
常见问题三:电脑中存在多个版本的 Python,如何指定运行?
表现:系统中既有系统自带的 Python 3.9,又有官方安装的 Python 3.12。
解决方法:可以使用具体的主次版本号指令来明确调用目标,例如直接输入 python3.12 启动新版解释器。在编写脚本或创建虚拟环境时,使用 python3.12 -m venv .venv 即可确保虚拟环境严格基于该指定版本构建。
按照上述步骤操作后,macOS 系统上便拥有了一个干净、标准且与系统底层严格隔离的 Python 3 运行环境。后续无论是进行日常脚本编写、学术数据分析还是大型项目工程,均可在此基础上稳定运行。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









