macOS 环境下 Python 安装与卸载实践指南

1. 安装

步骤 1：下载 Python 3.12 安装包

1. 访问 Python 官网 打开浏览器，访问：https://www.python.org/downloads/
2. 选择 macOS 版本 页面会自动检测你的系统，显示 macOS 下载按钮。 或者手动选择：
   • 点击'Download Python 3.12.x'（当前最新稳定版）
   • 或访问：https://www.python.org/downloads/macos/
   • 文件名类似：python-3.12.x-macos11.pkg
   • 文件大小：约 50-60 MB

选择正确的安装包 对于现代 macOS（10.9+），下载：

macOS 64-bit universal2 installer (.pkg)

例如：选择最新的稳定版本（如 Python 3.12.x），下载 .pkg 安装包。

步骤 2：安装 Python 3.12

1. 双击安装包 在「下载」文件夹中找到下载的 .pkg 文件，双击打开。
   • ✅ Install shell profile：创建命令行配置文件
   • ✅ Add Python to PATH：将 Python 添加到系统路径（非常重要！）
   • 安装位置：默认 /Library/Frameworks/Python.framework/Versions/3.12/
2. 等待安装完成 安装过程大约需要 1-2 分钟。

运行安装向导 按照提示一步步进行：

1. 欢迎界面 → 继续
2. 许可协议 → 继续 → 同意
3. 安装类型 → 推荐选择"安装"，保持默认位置
4. 重要：勾选「Install shell profile」和「Add Python to PATH」
5. 输入管理员密码确认

步骤 3：验证安装

1. 打开终端
   • 按 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

步骤 4：设置默认 Python 版本（可选）

如果你的系统有多个 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*

步骤 5：测试 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

2. Python 目录结构及常见问题和解决

2.1 安装后的目录结构

# 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
└── 其他工具

2.2 常见问题和解决

查看已安装的包

# 系统自带的包
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

3. 卸载

3.1 安装方式识别

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" 命令可能无效。

3.2 卸载方法

3.2.1 卸载 3.12 版本

# 删除主框架
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.command
• 更新 pip：pip3 install --upgrade pip
• 考虑安装 virtualenv：pip3 install virtualenv

这样安装的 Python 3.12 会与系统自带的 Python 完全隔离，不会影响 macOS 系统功能。

3.2.2 卸载其他版本（如 3.10）

从 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 应显示找不到。