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

检查 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 上不同安装方式的路径特征非常明显：

打开终端（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 应显示找不到。