2026 年 10 月 9 日,Python 3.15.0 正式发布,见 Python.org 发布记录。普通课程和入门练习先用标准版;安装器里的 free-threaded 版是额外测试选项,不是新手必须切换的默认路线。只有课程明确要求,或你要验证并发代码和依赖时,再单独测试它。
适合第一次在 Mac 上安装 Python 3.15、只想顺利完成课程练习的学生。
如果你已有项目、担心第三方包是否适配,或正通过远程 Mac 学习,也可以按下面的步骤核对解释器和运行结果。
最后更新于 2026 年 10 月 10 日,核对依据为 Python.org 的 3.15.0 发布记录及 Python 3.15 macOS、free-threading 官方文档。这些安装选项可能随后续版本说明调整,实际操作前应以 macOS 安装文档为准。
01 Python 3.15 Mac 安装选项:先按课程要求定标准版或额外版
先找老师给的版本要求、课程项目文件和依赖清单。课程指定某个 Python 版本,就先遵守指定版本;不要只因为新版本发布,就把作业环境换成 Python 3.15。若课程没有指定,且项目依赖没有验证过 free-threaded 版,标准版是更稳妥的起点。
安装器的额外选项叫 free-threaded Python。你可以把它理解成另一套实验用工具箱:它尝试让多个线程并行执行 Python 代码。线程是程序同时处理任务的一种方式;GIL(全局解释器锁)则是传统构建中限制多个线程同时执行 Python 代码的一道“闸门”。免除这道闸门不代表普通作业自动更快,也不代表所有包都能直接使用。Python 官方 free-threading 说明明确提醒,实际收益取决于程序,部分第三方包可能会重新启用 GIL。
Python 3.15 的 macOS 安装器默认会提供额外的 free-threaded 构建选项;它安装在单独的位置,可与标准构建并存。换句话说,选中它不等于把标准版替换掉。不过,两个构建有各自的包安装目录,给其中一个安装的依赖不一定能在另一个里直接使用。细节见官方 macOS 安装说明。
安装时是否需要启用 free-threaded 选项?
课程只是教基础语法、文件读写或普通作业时,先取消勾选也可以,减少选错解释器的机会;想主动学习 free-threaded 或课程明确要求时,再保留并单独测试。若你已经安装了它,也不必卸载:使用标准版创建课程环境即可。
02 依赖兼容性:先核对课程真正会导入的包
课程依赖清单通常在项目文件夹里的 requirements.txt、课程说明或安装指令中。先检查这些内容,不要把“某个包可以安装”直接当成“整个项目已兼容”。
纯 Python 包主要由 Python 代码组成;扩展模块则包含用 C 等语言编写、要和解释器衔接的部分。后者可能需要专门支持 free-threaded 构建。官方文档说明,未声明支持的 C 扩展可能发出警告,并在运行时重新启用 GIL;相关构建还可能需要单独的 wheel 文件。因此,不能仅凭包名或“安装成功”就判断它一定能以无 GIL 状态运行。可参照官方扩展模块支持说明。
课程项目依赖能否在 free-threaded 构建中运行?
要按课程项目逐项核对。先查看项目要求的 Python 版本,再查每个关键依赖的官方安装说明、支持版本和扩展模块说明;如果文档没有明确写支持,不要替作者推断兼容。首次导入出现警告、安装失败或作业结果不同,就回到课程要求的标准环境完成作业。
如果依赖文件存在,可在标准版虚拟环境中按课程指引安装。Python 官方打包指南也建议用 requirements 文件集中声明和安装项目依赖,避免手动漏项。(官方 pip 与虚拟环境安装指南)
03 解释器辨认:看路径和版本输出,不靠猜
解释器就是实际负责运行代码的 Python 程序。终端里输入的命令,可能因为路径顺序、别名或激活环境而指向不同程序。特别是同时装了标准版和 free-threaded 版时,终端显示的 python3 不足以证明你正在运行哪一个。
Mac 上的官方安装说明给出的 free-threaded 命令名是 python3.15t,标准版命令名是 python3.15。先分别运行:
python3.15 -VV
python3.15t -VV
which python3.15
which python3.15t
版本输出包含 free-threading build 时,才是在检查 free-threaded 构建;which 用来显示终端找到的程序路径。Python 官方也说明,-VV 会显示更完整的版本构建信息。若你的终端提示找不到命令,先不要改系统路径;回到安装器确认命令行工具是否安装,再使用文档所列的安装位置核验。
怎样确认终端实际调用的是哪一套 Python?
在你实际运行课程程序的同一个终端里,检查命令路径和 -VV 输出。还可以用 python -c "import sys; print(sys.executable)" 打印正在运行的解释器路径;官方 sys 文档说明,sys.executable 表示当前 Python 可执行文件的绝对路径。进入虚拟环境后,再执行一次检查,避免只确认了环境外的 Python。(Python 官方 sys 文档)
04 学习任务与维护成本:把两种构建分开试
第二步:按任务决定是否需要测试额外构建
- 普通语法课、作业和入门项目:使用课程要求的版本;未指定时,先选标准版。
- 课程明确要求 free-threaded:按要求建立独立环境,单独检查版本与包。
- 你想验证并发练习:用相同代码分别运行两种构建,再比较结果。不要预设 free-threaded 一定更快;官方文档指出,单线程任务存在额外开销,实际情况取决于负载和硬件。
第三步:每个项目建立自己的 Python 虚拟环境
虚拟环境可以想成项目专属的练习桌:这个项目安装的包和其他项目分开放,删除后也可以按清单重建。Python 官方 venv 文档说明,环境由选定的基础解释器创建,并默认与其他环境中的包隔离。(Python 官方 venv 文档)
在项目目录中,明确用标准版创建环境:
python3.15 -m venv .venv
source .venv/bin/activate
python -VV
python -c "import sys; print(sys.executable)"
要测试 free-threaded 构建时,另建一个环境,不要把两套依赖混装:
python3.15t -m venv .venv-ft
环境激活后再安装课程要求的依赖。使用 python -m pip,能让安装命令跟着当前调用的解释器走;若项目提供依赖文件,按老师要求或文件说明安装。虚拟环境不能代替课程版本核对,也不宜直接复制到另一台机器;需要迁移时,根据项目依赖重新创建更可靠。
第四步:受限设备上不改受保护目录
学校电脑若限制安装或修改软件,不要覆盖系统 Python、改写受保护目录,也不要擅自调整管理员设定。先确认学校允许使用的解释器和项目路径;权限不足时,向老师或管理员确认批准的方案。环境问题可能来自权限,也可能来自命令指向错误,先查看路径再处理,别用管理员权限盲目重装。
05 按顺序验收,失败就回到课程指定环境
第五步:用一项课程任务做完整验收
- [ ] 在课程说明中记下指定的 Python 版本与依赖。
- [ ] 选择标准版或课程要求的构建,并在项目目录创建独立虚拟环境。
- [ ] 激活环境,运行
python -VV和python -c "import sys; print(sys.executable)",确认版本与路径。 - [ ] 按课程清单安装依赖;逐项运行项目实际使用的导入语句。
- [ ] 运行一项课程示例或作业,检查输出是否符合预期。
- [ ] 测试 free-threaded 时,再单独运行同一任务并留意导入警告、自动启用 GIL 的提示或结果差异。
- [ ] 任何依赖无法安装、关键模块导入失败或作业结果异常,都先切回课程指定的标准环境,不要继续把故障归因于自己的代码。
这套顺序把故障拆成了三件事:选对解释器、装齐依赖、跑通项目。只看到版本号正确还不算验收通过;只有课程任务在对应环境里正常运行,才说明这套组合适合当前作业。
06 没有本地 Mac 时,如何完成 macOS 环境核验
如果你平时用 Windows 学基础 Python,且课程不要求 macOS,没必要为了装一个解释器立刻换电脑。Windows 本地环境做日常练习方便;但当课程必须在 macOS 上核验、学校设备不允许安装,或你需要排查“我的环境和老师演示是否一致”时,Windows 本机就缺少原生 macOS 环境,来回切换设备也会让文件位置和终端路径更难对照。
远程 Mac 也有代价:网络响应可能影响操作手感;项目文件需要安排好上传、下载或版本管理;按周期租用会产生持续费用。若你只做普通 Python 练习,本地可用环境通常更省事。若只是临时完成 macOS 课程验收,可先了解 CALMVPS 的远程 Mac 使用入口及方案与费用说明,再判断短期租用是否比购买设备更合适。需要的是在真实 Mac 上检查解释器、依赖和项目结果时,租用 Mac 环境能省去购买整台设备的门槛;但如果你长期持续重负载,或必须接触本地物理接口,应优先评估自有设备,而不是默认租用。
先按课程要求选标准版,把项目放进独立虚拟环境,并以实际作业验收。只有课程要求或测试目标明确时,再启用 free-threaded 版;异常时先确认解释器路径,仍不通过就回退到课程指定环境。