Mac 新手怎么正确安装 Python 并配置基础开发环境

在 Mac 上正确配置 Python 开发环境的核心原则只有两条：绝不直接污染系统内置环境，以及每个独立项目始终使用独立的虚拟环境（venv）。本文为初学者梳理清晰的操作链路，从安装最新版 Python 解释器、验证终端路径，到创建项目专属虚拟环境、配置 VS Code 代码编辑器，一步步构建干净、稳定且易于维护的开发底座。

一、了解 Mac 自带环境与常见误区

打开 Mac 终端输入命令时，许多新手会发现系统中似乎已经存在某些 Python 相关的文件或提示。此时很容易产生两个误区：一是认为直接拿系统自带的环境就能写代码；二是遇到权限问题时习惯性使用 sudo pip install 强制往系统目录写入文件。

macOS 过去曾内置 Python 2.7（已在 macOS 12.3 后正式移除），如果安装了 Xcode 或 Command Line Tools，系统还会附带一个供系统内部工具与编译脚本调用的 Python 运行时。这个运行时受到苹果系统完整性保护（SIP）与 PEP 668 规范的严格约束，它是受保护的外部托管环境（Externally Managed Environment）。如果在该环境下随意安装第三方库，轻则导致版本冲突报出红字错误，重则干扰系统开发工具的正常工作。

二、选择与安装 Python 解释器（两种可靠方式）

对于 Mac 用户，目前业内最成熟、受官方和社区长期支持的安装方式有两种：Python 官方安装包（PKG）与 Homebrew 包管理器。初学者可根据自身对终端的熟悉程度进行选择：

方式一：使用官方 PKG 安装包（最直观）

1. 下载安装包：在浏览器中访问 Python 官方网站下载页（https://www.python.org/downloads/macos/），网站会自动识别当前 Mac 芯片架构并提供最新的稳定版安装包（例如 Python 3.12.x 或 3.13.x 的 macOS 64-bit universal2 installer，它同时原生支持 Apple Silicon M 系列与 Intel 芯片）。
2. 运行安装向导：双击下载好的 .pkg 文件，按照屏幕提示连续点击“继续”并同意许可协议，输入 Mac 开机密码完成安装。
3. 运行证书安装脚本（重要）：官方安装完成后会在访达（Finder）中自动弹出一个名为“Python 3.x”的文件夹。请务必双击运行其中的 Install Certificates.command 脚本。该脚本会自动为 Python 关联 macOS 的根证书系统。如果不执行这一步，后续通过代码发起 HTTPS 请求或某些网络操作时可能会遭遇 SSL: CERTIFICATE_VERIFY_FAILED 错误。

方式二：使用 Homebrew 安装（包管理更统一）

如果你的 Mac 已经配置了 Homebrew（Mac 下最流行的包管理器），通过命令行安装维护会更为简明：

# 1. 更新 Homebrew 仓库信息并安装 Python
brew update
brew install python

# 安装完成后，Homebrew 会自动将 python3 链接至系统 PATH

三、打开终端验证全局安装结果

安装完成后，按下键盘上的 Command + 空格键 调出聚焦搜索（Spotlight），输入 终端（Terminal）并按回车打开。在出现的黑色或白色命令行窗口中依次执行以下检测：

# 1. 检查 Python 3 版本
python3 --version
# 正常终端示例输出：Python 3.12.3

# 2. 检查命令实际指向的二进制路径
which python3
# 官方安装包输出示例：/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
# Homebrew（Apple Silicon芯片）输出示例：/opt/homebrew/bin/python3

许多新手此时会有疑问：“为什么必须敲 python3 而不能直接敲 python？” 这是因为在 Unix 系统历史中，python 命令过去常用于绑定 Python 2。为了防止系统老旧脚本发生非预期破坏，现代 macOS 默认没有创建 python 到 python3 的软链接。在 Mac 上，请养成始终明确使用 python3 和 pip3 的好习惯。

四、必须掌握的关键一步：使用 venv 虚拟环境

这是 Mac 新手最容易忽略、却最为关键的一步。当你在终端直接运行 pip3 install requests 时，现代 Python 会直接拦截并抛出如下提示：

error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages in this environment, create a venv...

这不是故障，而是官方为防止用户不加节制地向全局写入各种不兼容的依赖库而引入的保护机制。正确的做法是：为你的每一个具体项目建立一个独立的虚拟环境（virtual environment）。

虚拟环境的标准使用四步法

1. 创建项目文件夹并进入：

   mkdir -p ~/Developer/my_project
   cd ~/Developer/my_project

2. 在项目根目录下创建虚拟环境：

   # .venv 为虚拟环境目录名，前置点号表示在访达中默认隐藏，避免干扰
   python3 -m venv .venv

3. 激活虚拟环境：

   source .venv/bin/activate
   # 激活成功后，终端提示符最前端会出现 (.venv) 标识

4. 在虚拟环境中自由安装与管理依赖：

   # 此时直接使用 pip，无需 sudo，所有包均存入 .venv 目录
   pip install requests
   
   # 退出当前虚拟环境（工作结束时）
   deactivate

五、配置轻量且强大的代码编辑器：VS Code

在终端中执行简短语句适合测试，但真正的代码编写需要一个趁手的编辑器。对于 Mac 用户，Visual Studio Code（VS Code）是目前门槛最低、功能最丰富且完全免费的开发工具。

1. 下载与安装 VS Code

前往 VS Code 官网（https://code.visualstudio.com），下载 Mac 版本的 .zip 压缩包。解压后得到 Visual Studio Code.app，将其直接拖移进“应用程序”（Applications）文件夹中即可。

2. 安装 Python 官方扩展

打开 VS Code，点击左侧活动栏的方块图标（扩展 Extensions，快捷键 Command + Shift + X），在搜索框中输入 Python，找到由 Microsoft 官方发布的扩展插件，点击“Install”安装。该扩展会自动集成代码自动补全、语法高亮、代码格式化与调试器。

3. 打开项目并绑定虚拟环境解释器

在 VS Code 中点击菜单栏 文件 -> 打开文件夹...，选中刚才创建的 my_project 目录。

此时需要告诉 VS Code 使用我们刚才创建的虚拟环境：

• 按下快捷键 Command + Shift + P 打开命令面板；
• 输入 Python: Select Interpreter（选择解释器）并按回车；
• 在弹出的列表中，VS Code 通常会自动识别并推荐 ./.venv/bin/python，点击选中它即可；
• 选中后，VS Code 右下角的状态栏会常驻显示类似 Python 3.12.x ('.venv': venv) 的字样。此时在 VS Code 中新建内置终端（快捷键 Control + ~），编辑器还会自动替你执行 source .venv/bin/activate，无需手动切换。

4. 编写并运行第一行代码

在项目根目录下新建一个名为 main.py 的文件，输入以下测试代码：

import sys

def main():
    message = "Hello, Mac Python Development!"
    print(message)
    print(f"当前运行解释器: {sys.executable}")

if __name__ == "__main__":
    main()

点击编辑器右上角的三角形“运行”按钮，下方终端将立即打印运行结果，且输出的解释器路径明确指向当前项目目录下的 .venv/bin/python，证明整个开发环境配置完全正确。

六、新手常见问题与排查指南