Python 3.12.0官方下载与Windows/Mac安装步骤
本文详细介绍Python 3.12.0在Windows与macOS双平台的官方下载途径、安装包类型辨析、标准安装流程、环境变量配置与系统验证步骤,帮助开发者搭建稳定纯净的Python环境。
完成 Python 3.12.0 的环境搭建,核心在于直接获取官方发布的独立安装包、执行符合工程规范的安装选项配置,并理顺系统环境变量与解释器调用路径。本文提供 Windows 与 macOS 双系统的标准化安装流程、关键配置决策说明以及完整的命令行验证方法,协助搭建干净、可控且无多版本冲突的开发环境。
一、官方下载途径与安装包选型辨析
获取 Python 官方安装包的唯一权威来源是 Python 官方基金会网站(python.org)。对于 Python 3.12.0 这一具体的正式版本,官方归档页面提供了针对不同操作系统与处理器架构的专属分发文件。在选择具体下载项目时,需要辨析几个常见的理解偏差。
观点 1:“在 Windows 上直接从 Microsoft Store(应用商店)搜索安装最省事”
这一做法看似省去手动配置,但在实际编程场景中存在明显限制。应用商店版本受到 Windows UWP 应用沙盒策略保护,其实际安装路径位于隐藏且受权限保护的 AppData 虚拟包目录中。这会导致 Scripts 目录中的可执行脚本权限受限、部分 C 扩展包无法正确定位编译器头文件,因此不推荐使用商店版本作为主力开发环境。
观点 2:“macOS 系统自带 Python,不需要另外去官网下载”
早年 macOS 内置了 Python 2.7(目前已被系统完全剔除),而安装 Xcode 命令行工具附带的 /usr/bin/python3 属于系统组件配套环境,其更新跟随 macOS 系统更新,无法自由调整小版本,且缺少完整的第三方库软链接管理。通过官网安装标准的 .pkg 文件,会将 Python 部署在独立的 /Library/Frameworks/Python.framework 目录下,确保开发环境与系统组件互不干扰。
官方归档下载的具体规范如下:
- 官方发布列表访问路径:进入
https://www.python.org/downloads/,向下滚动查找 “Looking for a specific release?”,选择 Python 3.12.0,或直接进入 Release 归档页https://www.python.org/downloads/release/python-3120/。 - Windows 安装包选用:在页面底部的 Files 表格中,选择 Windows installer (64-bit)。文件名格式为
python-3.12.0-amd64.exe。若使用 ARM 架构设备(如某些高通芯片笔记本),则选择Windows installer (ARM64)。 - macOS 安装包选用:选择 macOS 64-bit universal2 installer。文件名格式为
python-3.12.0-macos11.pkg。该通用二进制包同时原生支持 Apple Silicon(M1/M2/M3/M4 系列)和 Intel x86_64 处理器。
二、Windows 平台安装详细步骤
在 Windows 环境下,双击运行 python-3.12.0-amd64.exe 启动安装向导。以下操作步骤决定了后续在命令行中调用 Python 是否顺畅。
1. 勾选环境变量核心选项
在安装向导首个欢迎界面中,底部提供两个复选框:
Use admin privileges when installing py.exe:勾选,便于全局调度 Python 启动器。Add python.exe to PATH(将 python.exe 添加到 PATH 环境变量):务必勾选。如果遗漏此项,Windows 将无法在任意目录的命令提示符或 PowerShell 中识别python命令。
2. 选择自定义安装(Customize installation)
点击 “Customize installation” 进入配置明细页。在 Optional Features(可选功能)中,确认全部项目保持勾选状态:
Documentation(离线帮助文档)pip(Python 官方包管理工具,必选)tcl/tk and IDLE(内置轻量级开发环境与 GUI 支持库)Python test suite(标准库测试套件)py launcher及其for all users选项(全局启动器)
3. 高级配置(Advanced Options)与安装路径设定
点击 “Next” 进入 Advanced Options 界面,建议做出如下设置:
- 勾选
Install Python 3.12 for all users:此举将默认安装目标转移至全局程序目录,避免因为用户文件夹包含中文字符或空格引发第三方库编译异常。 - 勾选
Precompile standard library:在安装过程中预编译标准库.py为字节码.pyc,提升后续冷启动性能。 - 检查
Customize install location(自定义安装路径):默认通常为C:\Program Files\Python312。亦可设定为C:\Python312方便日常运维。确保路径中无中文与特殊符号。
点击 “Install” 开始解压并写入文件。在 Windows UAC 提示窗口中选择“是”授权写入。
4. 解除 260 字符路径限制(Disable path length limit)
安装完成界面(Setup was successful)会提示 Disable path length limit。强烈建议点击该选项并授权。这会修改注册表中的 LongPathsEnabled 键值,解除 Windows 传统的 MAX_PATH(260个字符)限制,避免在使用深度依赖包或复杂虚拟环境时因路径过深报错。
三、macOS 平台安装详细步骤
在 macOS 系统中,下载 python-3.12.0-macos11.pkg 后直接双击运行苹果标准的安装器。
1. 逐步执行安装向导
- 简介与重要信息:点击“继续”。向导会明确说明该安装程序包含 Tcl/Tk 8.6、OpenSSL 等运行时库,并将安装至全局 Framework 路径。
- 许可协议:点击“继续”,并在弹窗中选择“同意”。
- 安装类型与目标位置:保留默认的系统盘(Macintosh HD),点击“安装”。输入 macOS 系统用户密码或通过 Touch ID 授权完成安装。
2. 运行 SSL 证书安装脚本(关键必要步骤)
与 Windows 版不同,macOS 官方包自带独立的 OpenSSL 运行库,默认并不直接信任系统的钥匙串证书(Keychain)。如果跳过证书配置,使用 Python 的 urllib 模块或第三方库爬取 HTTPS 网站时,会触发 ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] 异常。
安装完成后,系统会自动打开 Finder 窗口展示 /Applications/Python 3.12 文件夹。此时需要:
- 双击运行
Install Certificates.command脚本。该脚本会自动下载并提取最新的certifi证书包,链接至 Python 3.12 框架的证书信任链中。 - (可选)双击运行
Update Shell Profile.command脚本,确保终端启动脚本中配置了最新的 PATH 变量。
四、安装结果验证与交互测试
完成安装包执行后,不要直接在已经打开的旧终端窗口运行命令,而应重新启动一个新的终端窗口(Windows 下为 cmd 或 PowerShell,macOS 下为 Terminal/iTerm2),以便让系统加载最新的环境变量。
1. 核心命令版本核对
在控制台中依次执行以下检查命令:
# 1. 检查 Python 解释器主版本
python --version
# 或在 macOS 下优先使用显式指定版本的命令
python3 --version
# 2. 检查 pip 包管理器版本与绑定的 Python 版本
pip --version
# 或在 macOS 下使用
pip3 --version
# 3. 检查可执行二进制文件的实际路径(排查路径优先级)
# Windows 环境
where python
# macOS 环境
which python3
在标准安装下,终端应返回如下清晰的版本信息(以实际输出示例为准):
[Windows 示例输出]
C:\Users\Developer> python --version
Python 3.12.0
C:\Users\Developer> pip --version
pip 23.2.1 from C:\Python312\Lib\site-packages\pip (python 3.12)
C:\Users\Developer> where python
C:\Python312\python.exe
C:\Users\Developer\AppData\Local\Microsoft\WindowsApps\python.exe
[macOS 示例输出]
% python3 --version
Python 3.12.0
% pip3 --version
pip 23.2.1 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
% which python3
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
2. 解释器运行与基础功能验证
通过命令行执行单行代码测试,验证解释器与基础算力模块是否正常运转:
python -c "import sys; print('Platform:', sys.platform); print('Executable:', sys.executable)"
若输出了对应的系统平台标识及解释器路径,说明解释器二进制文件与标准库链接完全正常。
五、常见问题排查与速查清单
| 故障现象 | 主要原因分析 | 具体修复方法 |
|---|---|---|
Windows 终端提示:'python' 不是内部或外部命令 |
安装时未勾选 “Add python.exe to PATH”,当前命令行会话无法检索到可执行文件。 | 打开“系统属性” -> “环境变量”,在系统变量 Path 中手动追加:1. C:\Python312\2. C:\Python312\Scripts\保存后重新打开 cmd 窗口。 |
macOS 终端运行 pip install 报错:SSL: CERTIFICATE_VERIFY_FAILED |
macOS 版 Python 自带的 OpenSSL 未加载根证书信任库。 | 进入访达,打开 /Applications/Python 3.12/ 目录,双击运行 Install Certificates.command 即可一键补全证书链。 |
Windows 终端运行 python 时自动弹出应用商店界面 |
Windows 预设的应用执行别名(App execution aliases)优先级高于未完全生效的实际路径。 | 打开 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”,关闭 python.exe 和 python3.exe 的别名开关。 |
| 多版本共存时调用的版本不符合预期 | 系统中残留有旧版 Python 路径,且在 PATH 列表中排在前列。 | 在 Windows 下推荐使用官方启动器 py -3.12 -m pip ... 精确指定版本;在 macOS 下通过 python3.12 显式调用。 |
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













