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/

3. 选择正确的安装包

   对于现代 macOS（10.9+），下载：

   macOS 64-bit universal2 installer (.pkg)

   • 文件名类似：python-3.12.x-macos11.pkg
   • 文件大小：约 50-60 MB

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

https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg

步骤2：安装 Python 3.12

1. 双击安装包

   在「下载」文件夹中找到下载的 .pkg 文件，双击打开。

2. 运行安装向导

   按照提示一步步进行：

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

   关键选项说明：

   • ✅ Install shell profile：创建命令行配置文件
   • ✅ Add Python to PATH：将 Python 添加到系统路径（非常重要！）
   • 安装位置：默认 /Library/Frameworks/Python.framework/Versions/3.12/

3. 等待安装完成

   安装过程大约需要 1-2 分钟。

步骤3：验证安装

1. 打开终端

   • 按 Cmd + Space 搜索「终端」或「Terminal」
   • 或打开「应用程序」→「实用工具」→「终端」

2. 检查 Python 版本

   # 检查 Python 3.12
   python3.12 --version
   # 应该显示：Python 3.12.x
   
   # 检查 python3 是否指向 3.12
   python3 --version
   
   # 检查 pip
   pip3 --version
   pip3.12 --version

3. 检查安装位置

   which python3.12
   # 应该显示：/Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
   
   which python3
   # 应该显示：/usr/local/bin/python3（符号链接）

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

如果你的系统有多个 Python 版本，可以设置 3.12 为默认：

1. 检查当前链接

   ls -la /usr/local/bin/python*

2. 如果 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

步骤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. 常见问题和解决

1. 安装后命令未找到

   # 重启终端
   # 或手动添加 PATH
   echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc

2. 证书验证错误

   # 运行以下命令修复 SSL 证书
   open /Applications/Python\ 3.12/Install\ Certificates.command

3. 查看已安装的包

   # 系统自带的包
   pip3 list
   
   # 用户安装的包
   pip3 list --user

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 3.10 的安装路径：

which python3.10

/Library/Frameworks/Python.framework/Versions/3.10/bin/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. 卸载python3.10

打开终端（Terminal），输入以下命令查看 Python 3.10 的安装路径：

which python3.10

/Library/Frameworks/Python.framework/Versions/3.10/bin/python3.10

从 Python 官网下载安装包安装了 Python 3.10，需要手动删除相关文件：

删除 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 3.12 的相关文件，手动删除。

在 /usr/local/bin目录下，这些文件都删除吗？

2to3 idle3.10 pydoc3.10 python3.10-config

2to3-3.10 ollama python3 python3.10-intel64

chromedriver pip3 python3-config

idle3 pydoc3 python3-intel64

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

sudo rm -rf /usr/local/bin/python3-intel64

完成后，重启终端或运行 hash -r 清除路径缓存，再输入 which python3.10 应该就显示找不到了。