macOS怎么下载安装Python并配置环境变量

青禾
青禾
发布时间:2026-11-19| 5人浏览过
原创

详细介绍在macOS系统上下载、安装Python的完整方法,涵盖官网PKG安装包与Homebrew两种主流路径,深入解析zsh环境下的PATH环境变量配置逻辑、证书安装与生效验证。

在 macOS 上搭建 Python 开发环境时,许多初学者经常遇到的困惑是:在终端中输入 python 提示找不到命令,或者输入 python3 却弹出了安装 Xcode Command Line Tools 的提示窗口。在 macOS Monterey(12.3)及更高版本中,苹果系统已经彻底移除了内置的 Python 2.7 运行环境,同时自带的 /usr/bin/python3 仅作为系统工具的底层运行依赖,并不适合用来作为个人开发的主环境。本文将详细演示如何在 macOS 上下载、安装独立的 Python 解释器,并解析如何在当前系统默认的 zsh 终端中正确配置 PATH 环境变量。

macOS Python 运行机制与环境路径划分

在动手安装之前,理解 macOS 查找可执行程序的顺序非常关键。当你在终端输入一条命令时,系统并不会全盘扫描硬盘,而是按照环境变量 PATH 中由冒号分隔的目录列表,从左到右依次查找同名二进制文件。一旦在前面的目录找到匹配项,就会直接执行并终止查找。

macOS怎么下载安装Python并配置环境变量
图 1:macOS 终端对 Python 执行路径的查找机制与环境分层

从上面的层级关系可以看出,我们安装 Python 并配置环境变量的核心目标,就是让自定义安装的 Python 目录位于 PATH 中更靠前的位置,从而确保终端输入 python3 时,调用的是我们下载维护的最新版本。

获取与安装 Python 的两种主流方案

在 macOS 上安装 Python,目前最主流、最稳定的途径有两种:通过 Python 官方安装包(PKG)或通过包管理工具 Homebrew。初次配置推荐选择官方安装包,安装过程直观透明,且附带完整的图形化工具与证书更新脚本。

方案一:通过官方网站下载并安装(推荐)

  1. 打开浏览器访问官方下载页面:https://www.python.org/downloads/macos/。
  2. 下载针对当前系统架构的安装包。现代 Mac 计算机分为 Apple Silicon 芯片(M1/M2/M3/M4 系列)和早期 Intel 芯片。官方提供的 macOS 64-bit universal2 installer 安装包同时包含了两种架构的代码,可直接兼容全部机型。
  3. 双击下载好的 .pkg 文件,按照屏幕提示逐步点击“继续”,并在软件许可协议处选择同意。
  4. 根据安装向导完成磁盘写入。官方安装包会将完整的 Python 运行时放置在系统框架目录 /Library/Frameworks/Python.framework/Versions/3.x/ 中。
macOS怎么下载安装Python并配置环境变量
图 2:从安装包下载到终端生效的完整执行步骤

关键遗漏项提醒:完成官方 PKG 安装后,请在“应用程序”中找到名为“Python 3.x”的文件夹,双击运行其中的 Install Certificates.command 脚本。macOS 上的官方 Python 默认不使用系统钥匙串证书,运行该脚本会自动安装 certifi 证书包,避免后续在使用 urllib 或 requests 访问 HTTPS 网址时抛出 SSL 证书验证失败错误。

方案二:通过 Homebrew 安装(适合开发者)

如果你已经在 Mac 上配置好了 Homebrew 包管理器,可以在终端中直接通过一行命令完成安装:

brew install python

Homebrew 会自动解析依赖并下载最新稳定版。值得注意的是,不同芯片架构的 Homebrew 默认前缀不同:

  • Apple Silicon(M 系列芯片):可执行程序位于 /opt/homebrew/bin/python3。
  • Intel 架构:可执行程序位于 /usr/local/bin/python3。

配置环境变量 PATH 的完整操作步骤

很多读者在安装后输入 python3 --version 依然显示旧版本或提示找不到命令,原因在于当前使用的终端会话并没有把 Python 的可执行程序目录加载进 PATH 中。下面以 macOS 自 Catalina(10.15)起默认使用的 zsh 为例,展开具体的配置步骤。

macOS怎么下载安装Python并配置环境变量
图 3:Shell 配置文件加载流程与 PATH 拼接逻辑

第 1 步:确认当前使用的 Shell 类型

在“终端”应用程序中输入以下命令并回车:

echo $SHELL

输出示例:

/bin/zsh

如果输出结果以 zsh 结尾,对应配置文件为个人主目录下的 ~/.zshrc;若输出结果为 /bin/bash,对应配置文件为 ~/.bash_profile。本文后续操作均以默认的 ~/.zshrc 进行说明。

第 2 步:定位已安装 Python 的可执行目录

不同安装方式对应的二进制路径如下:

安装方式 系统架构 默认安装路径
官网 PKG 安装包 通用架构(Intel / Apple Silicon) /Library/Frameworks/Python.framework/Versions/3.12/bin(版本号根据实际替换)
Homebrew Apple Silicon(M1/M2/M3/M4) /opt/homebrew/bin
Homebrew Intel Core 架构 /usr/local/bin

第 3 步:将路径写入配置文件

以官方 Python 3.12 安装包为例,我们使用终端文本编辑命令将路径添加到 ~/.zshrc 尾部。可以直接执行以下追加命令:

echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"' >> ~/.zshrc

如果你希望在终端直接输入 python 而不仅是 python3,可以顺带加入别名(alias)设置:

echo 'alias python="python3"' >> ~/.zshrc
echo 'alias pip="pip3"' >> ~/.zshrc

第 4 步:使环境变量配置立即生效

修改配置文件后,当前已经打开的终端窗口不会自动热加载新配置。执行以下命令使其在当前终端会话中立即生效:

source ~/.zshrc

关闭该终端并重新打开一个新的终端窗口也能达到相同的生效效果。

验证结果与环境检查清单

配置完成后,必须通过终端命令逐项核对环境是否正常工作。依次执行以下三个核心命令:

1. 检查 Python 解释器版本:

python3 --version

输出示例:

Python 3.12.3

2. 查看当前命令调用的实际磁盘物理路径:

which python3

输出示例:

/Library/Frameworks/Python.framework/Versions/3.12/bin/python3

如果输出的路径是 /Library/Frameworks/... 或 /opt/homebrew/...,证明环境变量优先级配置成功;如果依然显示 /usr/bin/python3,则说明 ~/.zshrc 中的 PATH 未正确加载或语法有误。

3. 检查包管理器 pip:

pip3 --version

输出示例:

pip 24.0 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)

日常使用与虚拟环境管理建议

macOS怎么下载安装Python并配置环境变量
图 4:macOS Python 规范工程环境规划与管理最佳实践

在 macOS 系统中配置好全局环境变量后,并不意味着所有的三方库都要直接安装在全局环境中。在日常开发过程中,应遵循以下工程实践:

  • 严禁使用 sudo pip install:使用超级管理员权限安装 Python 包会破坏系统或框架目录的权限结构,甚至污染底层组件。
  • 为每个独立项目建立虚拟环境:进入你的项目目录后,通过内置模块创建虚拟环境:
    python3 -m venv .venv
    source .venv/bin/activate
    激活虚拟环境后,终端提示符前会出现 (.venv) 字样,此时再执行 pip install package_name,所有依赖都会精确存放在当前工程目录下,不影响全局系统。
  • 退出虚拟环境:只需在终端中执行 deactivate,即可退回系统全局环境。

通过官方安装包完成主程序部署、在 ~/.zshrc 中校准 PATH 环境变量、执行证书配置脚本,并在具体项目中配合 venv 虚拟环境进行隔离,即可在 macOS 上建立起清晰、稳定且易于维护的 Python 开发环境。

相关专题:

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

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