1. 安装
步骤 1:下载 Python 3.12 安装包
- 访问 Python 官网 打开浏览器,访问:https://www.python.org/downloads/
- 选择 macOS 版本
页面会自动检测你的系统,显示 macOS 下载按钮。
或者手动选择:
- 点击'Download Python 3.12.x'(当前最新稳定版)
- 或访问:https://www.python.org/downloads/macos/
- 文件名类似:
python-3.12.x-macos11.pkg
本文介绍了在 macOS 系统上安装、配置及卸载 Python 3.12 的完整流程。内容包括从官网下载官方安装包、配置环境变量、验证安装状态以及处理常见证书问题。同时详细说明了不同安装方式(官方包、Homebrew 等)的路径特征,并提供了手动清理框架文件和符号链接的卸载命令,确保系统环境整洁且不影响系统自带 Python。
python-3.12.x-macos11.pkg选择正确的安装包 对于现代 macOS(10.9+),下载:
macOS 64-bit universal2 installer (.pkg)
例如:选择最新的稳定版本(如 Python 3.12.x),下载 .pkg 安装包。
.pkg 文件,双击打开。
/Library/Frameworks/Python.framework/Versions/3.12/运行安装向导 按照提示一步步进行:
1. 欢迎界面 → 继续
2. 许可协议 → 继续 → 同意
3. 安装类型 → 推荐选择"安装",保持默认位置
4. 重要:勾选「Install shell profile」和「Add Python to PATH」
5. 输入管理员密码确认
Cmd + Space 搜索「终端」或「Terminal」检查安装位置
which python3.12 # 应该显示:/Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
which python3 # 应该显示:/usr/local/bin/python3(符号链接)
检查 Python 版本
# 检查 Python 3.12
python3.12 --version # 应该显示:Python 3.12.x
# 检查 python3 是否指向 3.12
python3 --version
# 检查 pip
pip3 --version
pip3.12 --version
如果你的系统有多个 Python 版本,可以设置 3.12 为默认:
如果 python3 没有指向 3.12,可以手动链接
# 删除旧的链接(如果存在)
sudo rm -f /usr/local/bin/python3
# 创建新的链接
sudo ln -s /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12 /usr/local/bin/python3
# 同样处理 pip3
sudo ln -s /Library/Frameworks/Python.framework/Versions/3.12/bin/pip3.12 /usr/local/bin/pip3
检查当前链接
ls -la /usr/local/bin/python*
# 测试 Python 交互式环境
python3
# 输入以下代码测试:
print("Hello Python 3.12!")
import sys
print(f"Python version: {sys.version}")
# 按 Ctrl+D 退出
# 测试 pip 安装
pip3 install --upgrade pip
pip3 list
# Python 3.12 的主要安装位置
/Library/Frameworks/Python.framework/Versions/3.12/
├── bin/ # 可执行文件
├── lib/ # 库文件
└── Resources/ # 资源文件
# 命令行工具符号链接位置
/usr/local/bin/
├── python3.12 -> ../Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
├── python3 -> python3.12
├── pip3.12 -> ../Library/Frameworks/Python.framework/Versions/3.12/bin/pip3.12
└── pip3 -> pip3.12
# 应用程序位置
/Applications/Python 3.12/
├── IDLE.app # Python 集成开发环境
├── Python Launcher.app
└── 其他工具
查看已安装的包
# 系统自带的包
pip3 list
# 用户安装的包
pip3 list --user
证书验证错误
# 运行以下命令修复 SSL 证书
open /Applications/Python\3.12/Install\ Certificates.command
安装后命令未找到
# 重启终端
# 或手动添加 PATH
echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
macOS 上不同安装方式的路径特征非常明显:
| 安装方式 | 典型路径特征 |
|---|---|
| 官方安装包 | /Library/Frameworks/Python.framework/Versions/X.X |
| Homebrew | /opt/homebrew/bin/python3 (M1/M2) 或 /usr/local/bin/python3 (Intel) |
| pyenv | ~/.pyenv/versions/3.10.x/bin/python3 |
| Anaconda | ~/anaconda3/bin/python3 或 ~/miniconda3/bin/python3 |
| 系统自带 | /usr/bin/python3 (实际上是 Python 2.7 的 wrapper) |
打开终端(Terminal),输入以下命令查看 Python 安装路径:
which python3.10
官网下载的 Python.org 安装包:这些通常不会被 pkgutil 注册,
pkgutil --pkgs | grep -i "python3.10"命令可能无效。
# 删除主框架
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12
# 删除应用程序
sudo rm -rf "/Applications/Python 3.12"
# 删除符号链接
sudo rm -f /usr/local/bin/python3.12
sudo rm -f /usr/local/bin/python3
sudo rm -f /usr/local/bin/pip3.12
sudo rm -f /usr/local/bin/pip3
sudo rm -f /usr/local/bin/idle3.12
sudo rm -f /usr/local/bin/pydoc3.12
sudo rm -f /usr/local/bin/2to3-3.12
建议
/Applications/Python\ 3.12/Install\ Certificates.commandpip3 install --upgrade pippip3 install virtualenv这样安装的 Python 3.12 会与系统自带的 Python 完全隔离,不会影响 macOS 系统功能。
从 Python 官网下载安装包安装了旧版本,需要手动删除相关文件:
删除 Python 框架:
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.10
删除可执行文件链接:
sudo rm -rf /usr/local/bin/python3.10
sudo rm -rf /usr/local/bin/pip3.10
删除其他相关文件:
检查 /usr/local/lib、/usr/local/share 等目录下是否有相关 Python 文件,手动删除。常见需清理的文件包括:
sudo rm -f /usr/local/bin/python3.10
sudo rm -f /usr/local/bin/python3.10-config
sudo rm -f /usr/local/bin/idle3.10
sudo rm -f /usr/local/bin/pydoc3.10
sudo rm -f /usr/local/bin/2to3-3.10
sudo rm -f /usr/local/bin/python3.10-intel64
sudo rm -f /usr/local/bin/2to3
sudo rm -f /usr/local/bin/pydoc3
sudo rm -f /usr/local/bin/python3
sudo rm -f /usr/local/bin/python3-config
sudo rm -f /usr/local/bin/idle3
sudo rm -rf /usr/local/bin/pip3
完成后,重启终端或运行 hash -r 清除路径缓存,再输入 which python3.10 应显示找不到。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online