Mac 新手怎么安装 Python 并配置环境变量

一、Mac 新手安装 Python 前的必要认知

很多初学者在 Mac 终端中输入 python 时，可能会遇到提示“command not found”或者弹出需要安装命令行开发者工具（Command Line Tools）的窗口。在开始安装前，理解 macOS 现有的系统环境是避免混乱的第一步。

在 macOS 12.3 之前，苹果系统曾自带较旧的 Python 2.7 版本，但从该版本起苹果已彻底移除了系统默认的 Python 2。当前系统内置的开发工具链（Xcode Command Line Tools）虽然可能附带 python3 替身，但其主要供苹果系统组件与底层开发工具使用，版本更新随系统升级而定，且缺少常规的包管理便利性。

因此，对于编程学习、数据分析或自动化脚本开发，新手应当在独立的用户目录下安装标准的最新版 Python。官方安装包会将解释器、标准库以及 pip 统一安装至标准的框架路径下，与系统底层文件完全隔离，既安全又易于维护。

二、通过官方安装包安装 Python 的完整步骤

虽然 macOS 社区也常使用 Homebrew 包管理器，但对于首次接触终端的读者，Homebrew 需要先在终端安装基础工具及配置网络源，门槛相对偏高。相比之下，官方图形化安装包（.pkg 文件）是最直接可靠的途径。

步骤 1：下载官方 macOS 安装包

打开 Mac 自带的 Safari 浏览器，访问 Python 官方网站的下载页面（python.org/downloads/macos/）。页面会自动识别 macOS 系统并提供适用于最新稳定版的“macOS 64-bit universal2 installer”安装包。这里的“universal2”代表该安装包同时原生支持苹果芯片（M1/M2/M3/M4 系列等 Apple Silicon）以及传统的 Intel 芯片架构。

步骤 2：运行并完成向导安装

下载完成后，在“下载”文件夹中双击 python-3.x.x-macos11.pkg。安装向导将引导完成说明阅读、许可证确认与目标磁盘选择。新手一路点击“继续”和“同意”，并在最后输入 Mac 的开机解锁密码授权安装即可。

步骤 3：修复 macOS SSL 证书问题（关键步骤）

在安装完成时，系统会自动打开一个名为 Python 3.x 的访达（Finder）文件夹。在文件夹内会看到两个以 .command 结尾的文件：Install Certificates.command 与 Update Shell Profile.command。

双击 Install Certificates.command，终端会自动打开并执行证书证书安装脚本，当终端窗口底部出现 [进程已完成] 时，直接关闭该终端窗口即可。

三、环境变量工作原理与 PATH 机制

当在终端中敲下 python3 并按回车时，操作系统并不是凭空猜测该程序存放在哪里，而是通过名为 PATH 的环境变量来逐个目录查找同名可执行文件。

PATH 的本质是一串由英文冒号（:）隔开的文件夹路径列表。当输入指令时，系统会从列表中的第一个文件夹开始检查，一旦在该目录下找到了匹配的可执行文件，就会立即运行它并终止查找；如果搜寻完列表里的全部目录都没有找到，终端就会抛出 command not found 错误。

自 macOS Catalina（10.15）起，Mac 系统默认的 Shell 终端已经从 bash 改为 zsh。每次打开“终端”窗口时，zsh 会自动读取当前用户主目录下的配置文件 ~/.zshrc。因此，任何想要永久生效的路径修改或命令别名，都应该保存在 ~/.zshrc 文件中。

四、配置终端环境变量的具体操作

官方安装包通常会自动在 /usr/local/bin 生成软链接，而 macOS 默认的 PATH 中已经包含了该路径。但在日常使用中，很多教程和新手习惯直接输入 python 而不是输入 python3。此时可以通过在 ~/.zshrc 中配置别名（alias）或显式追加完整路径来完成配置。

1. 打开终端应用程序

按下键盘快捷键 Command + 空格键 唤起聚焦搜索（Spotlight），输入“终端”或“Terminal”，回车打开终端窗口。

2. 查看当前的 Shell 类型

在终端中输入以下命令以核对当前 Shell：

echo $SHELL

示例输出：

/bin/zsh

若输出包含 zsh，则代表使用现代 macOS 默认配置，操作的目标文件为 ~/.zshrc。

3. 配置别名与环境变量

为让终端中的 python 直接调用 python3，并让 pip 直接调用 pip3，在终端依次运行以下追加命令：

echo 'alias python="python3"' >> ~/.zshrc
echo 'alias pip="pip3"' >> ~/.zshrc
echo 'export PATH="/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH"' >> ~/.zshrc

这里各条命令的作用如下：

• echo 'alias python="python3"' >> ~/.zshrc：在配置文件末尾写入别名规则，当输入 python 时自动转为执行 python3。
• echo 'alias pip="pip3"' >> ~/.zshrc：让 pip 统一映射到 pip3，避免使用时因命令名称差异而困惑。
• export PATH="/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH"：将官方安装的 Python 专属 bin 目录置于 PATH 最前端，确保终端优先调用刚安装的版本。

4. 立即激活配置

修改 ~/.zshrc 后，修改不会直接作用于已打开的终端窗口。需要执行 source 命令立即重新加载配置，或者直接关闭当前终端窗口重新打开一个新窗口：

source ~/.zshrc

五、安装与配置结果验证

配置完成后，需要在终端运行基础检查命令，确认环境是否真正就绪。

1. 验证 Python 版本与命令指向

在终端输入以下命令：

python3 --version
python --version
which python3

示例输出：

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

如果两个版本命令均能打印出刚刚安装的 Python 3 版本号，且 which 指向框架目录或 /usr/local/bin/python3，说明解释器已正确安装并成功加入系统索引。

2. 验证包管理工具 pip

继续在终端测试包管理器：

pip3 --version
pip --version

示例输出：

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

3. 运行一行 Python 代码测试交互式终端

在终端直接输入 python3 并按回车，会进入 Python 交互式命令行环境（提示符为 >>>）：

>>> print("Hello, Mac Python!")
Hello, Mac Python!
>>> exit()

屏幕正确输出文字后，输入 exit() 并按回车即可退出交互式环境返回终端。

六、新手常见问题与避坑清单