Mac 配置 Python 开发环境：2026 新手从安装到运行

Python 标准库中的 venv 自 Python 3.3 起就能创建独立项目环境，避免不同项目的依赖互相影响（Python 官方文档）。因此，Mac 配置 Python 开发环境时，先确认课程指定的 Python 版本，再选择官方安装器或 Homebrew，最后为每个项目单独建环境；不必为了“最新版”跳过课程要求，也不必为了学普通 Python 先买 Mac。

适合谁看：第一次在 Mac 上学习 Python、需要从安装走到运行首段代码的学生。
已经装过 Python、却不确定课程项目使用哪个版本的初学者，也可以从环境隔离部分开始。
如果暂时没有 Mac，但课程要求使用 macOS，可据课程对本地文件、图形界面和设备访问的要求判断远程练习是否合适。

动手前：先核对课程要求，不要急着安装

先翻课程主页、作业说明或项目文件，找出 Python 版本、编辑器，以及是否提供 requirements.txt、pyproject.toml 等依赖说明。课程如果明确要求某个版本，安装目标就应与它一致；“版本号更大”并不等于作业一定能正常运行。

系统里可能存在不止一套 Python。可以把它想成电脑上有几把外观相似的钥匙：终端里输入 python3 时，系统会按搜索路径找到其中一把；编辑器或虚拟环境又可能指定另一把。只看见“安装成功”还不够，必须确认实际执行的是哪一个解释器。

课程只写了 Python 3，没有写小版本，该怎么选？先查看课程示例、老师提供的环境文件和依赖说明，再选择官方当前提供的稳定安装包；如果课程项目已指定版本，就优先遵守项目要求，不要自行升级后再排查兼容问题。可从 Python 官方 macOS 下载页查看安装包，并阅读官方 Mac 使用说明。

开始前可勾选以下项目，少一项就先补齐信息：

[ ] 已记录课程要求的 Python 版本；若没有明确版本，已确认课程项目的兼容要求。
[ ] 已找到课程指定的编辑器或 IDE；若未指定，先用终端完成基础验证。
[ ] 已确认项目是否有依赖文件；不要在看不懂来源时随意安装网上复制的包。
[ ] 已确认这台 Mac 的 macOS 版本，以及账户是否允许安装软件。

选择安装方式：官方安装器还是 Homebrew？

这两条路径都能用于 Mac 上的 Python 学习，区别在于谁负责安装和后续管理。官方安装器更直接，Homebrew 则适合已经用它管理开发工具、也愿意理解命令行安装流程的用户。

安装路径	更适合的情况	需要留意的地方
Python 官方 macOS 安装器	初次安装、希望从 Python 官方下载页获取安装包	安装后仍要确认终端实际调用的解释器；课程指定版本时，需选择相应的可用安装包
Homebrew Python	已在使用 Homebrew 管理开发工具，希望用同一套工具更新软件	Homebrew 提供的 Python 版本会随公式维护而变化，不应把它当成固定的小版本

新手该选哪种？如果课程没有要求使用 Homebrew，且目标只是安装 Python 并完成练习，官方安装器通常更容易理解；如果已熟悉 Homebrew，或课程说明明确要求用它管理工具，再选 Homebrew。Homebrew 文档指出，其 macOS 默认安装前缀在 Apple 芯片 Mac 上为 /opt/homebrew，在 Intel Mac 上为 /usr/local，这也解释了为什么不同电脑的终端路径可能不同（Homebrew 安装说明）。

选择 Homebrew 前，还要核对这台 Mac 是否满足其当前系统要求；Homebrew 文档列出的 macOS 要求会随支持政策变化，不能照搬旧教程的系统版本结论。它还说明，公式的默认 Python 小版本会随上游版本采用情况改变（Homebrew 语言运行时说明）。因此，指定版本的课程项目尤其需要在安装后再次检查，而不是仅凭 brew install 已完成就认定环境符合要求。

Homebrew Python 怎么安装？先按 Homebrew 官方安装说明确认安装方式和终端配置，再执行安装：

brew install python

安装结束后，不要急着重复执行安装命令。先关掉并重新打开终端，或按安装说明完成 shell 配置，再检查终端是否能找到预期版本。

首次运行：确认终端找到的 Python 正是要用的那一个

先查看版本和命令位置：

python3 --version
which python3

输出会因实际安装方式和版本而不同。例如，版本命令应显示 Python 3.x.y 这类格式；which python3 则显示当前终端找到的程序路径。版本不匹配时，先对照安装位置和 shell 配置，不要马上再装一遍：重复安装可能增加另一套解释器，却不一定改变命令实际找到的路径。

安装完成后，怎样确认 Python 能执行代码？先检查 python3 --version，再创建脚本运行，便能同时验证解释器和代码执行是否正常。Python 官方说明介绍了 Mac 上使用 Python 的方式；解释器也可以在终端交互运行，或执行脚本文件（Python 解释器教程）。

先用交互模式试一条简单语句：

python3

看到解释器提示符后输入：

print("Hello, Python!")

如果屏幕显示 Hello, Python!，说明这次交互运行成功。输入 exit() 退出，再验证脚本运行：新建一个名为 hello.py 的文件，写入同一条 print 语句，然后在文件所在目录执行：

python3 hello.py

如果出现 command not found，终端找不到这个命令；如果版本不对，说明调用路径和预期不一致。两种情况都应先核对安装是否完成、Homebrew 的 shell 配置是否生效，以及 which python3 的输出；不要靠反复安装来碰运气。

开始课程项目：每个项目配一个独立工具箱

Python 虚拟环境就像每门课各自的工具箱：一个项目装了某个版本的库，不会因此把另一个项目的工具也替换掉。Python 官方说明指出，venv 创建的环境会与基础安装中的包隔离；Python Packaging User Guide 的操作指南也建议在项目目录创建并启用虚拟环境。

进入项目目录后创建环境：

python3 -m venv .venv

在 macOS 终端启用它：

source .venv/bin/activate

启用后，命令行提示符通常会出现环境名；也可检查 Python 的位置：

which python
python --version

确认路径指向当前项目里的 .venv 后，再安装课程依赖。若项目提供依赖清单，先启用环境，再根据文件安装：

python -m pip install -r requirements.txt

python -m pip 会让 pip 由当前选中的 Python 解释器运行，这样比直接输入 pip 更容易确认包被装进哪套环境；可参考 pip 官方用户指南和依赖文件格式说明。如果项目没有依赖文件，不必预先安装一堆包，等代码或课程要求用到时再装。

要离开当前项目环境，可运行：

deactivate

下次继续该项目时，进入项目目录后重新启用 .venv 即可，不需要再创建一遍。虚拟环境目录一般不应作为项目代码提交；Python Packaging User Guide 也建议将环境目录排除在版本控制之外。

多个 Python 项目怎么避免环境冲突？为每个项目各自创建 .venv，在安装依赖前确认已启用对应环境；换项目时退出旧环境、进入新目录并启用新环境。这样，课程 A 所需的库不会无意间覆盖课程 B 的版本。

设备受限时：先判断课程是否真的需要 macOS

普通 Python 语法练习通常不以 Mac 为前提，课程若只要求编写和运行普通脚本，现有电脑已能满足要求，就没有必要为了 Python 学习专门更换设备。相反，如果课程明确依赖 macOS 专用工具、图形界面或本地设备访问，就需要确认当前设备是否能完成这些步骤。

学校电脑不允许安装软件时，可以先询问授课方是否提供实验室电脑、远程环境或课程指定的替代流程。远程 Mac 可以作为 macOS 练习的一种选择，但要留意网络连接、文件如何传入传出，以及课程是否要求直接连接本地设备；如果作业必须访问本机文件或外设，远程环境未必合适。

想先判断远程操作是否符合自己的课程流程，可查看 PingMini 的远程连接方式说明。是否租用不应先于课程要求作决定：先确认练习内容，再对照可用的连接与文件操作方式。

持续维护：升级之前先保留可复现线索

项目能运行后，记下使用的 Python 版本，并保存课程依赖文件。若项目没有现成的依赖清单，且确实需要记录当前环境，可以在项目虚拟环境启用时运行：

python -m pip freeze > requirements.txt

以后在新环境中，可用依赖文件重新安装包：

python -m pip install -r requirements.txt

记录文件并不自动保证所有电脑都能复现成功，课程指定的 Python 版本、操作系统和依赖兼容情况仍需一起核对。

升级 Python 或项目依赖前，先检查课程和项目是否支持新版本。出现报错时，保留完整错误文本，并一并记录当前目录、python --version、which python 的结果，以及虚拟环境是否已启用。这样能先分清问题来自代码、依赖还是解释器路径，而不是把不同问题混成一次“重新安装”。

对一般 Python 作业，购买 Mac 往往不是必要步骤；如果课程明确要求 macOS，而学校电脑又不允许安装软件，本地 Windows 环境会受操作系统要求限制，虚拟机则可能带来系统兼容和资源占用问题，自购 Mac 又意味着先承担设备成本。此时，PingMini 的远程 Mac 租赁可以作为临时练习的另一条路，省去先买一台 Mac 的投入；但它仍依赖网络，不适合必须离线工作或直接使用本地外设的作业。可先对照方案说明，再按课程要求决定在本地完成，还是使用远程环境练习。