macOS 系统 Python 环境升级指南
前置说明：Python 最新稳定正式版为 3.13.1，3.14 为开发预览版，不建议生产使用。下文以最新稳定版为准。
核心原则
操作基于以下原则，确保 macOS 环境安全：
原则 1：macOS 内置的 Python 2.7 不可修改
macOS 系统底层依赖自带的 Python 2.7（位于 /usr/bin/python），删除或修改会导致系统报错、终端失效等问题，请勿触碰。
原则 2：Python 3 升级采用新装高版本 + 共存模式
macOS 可同时存在多个 Python 3 版本（如 3.8、3.13）。目标是安装最新版并让 python3 指向新版本，旧版可保留或卸载。
原则 3：python 与 python3 命令独立
python→ 调用系统内置 Python 2.7python3→ 调用安装的 Python 3.x 版本pip/pip3→ 分别对应 Python 2.7 和 Python 3.x 的包管理工具
方案一：Homebrew 安装/升级 Python 3（推荐）
Homebrew 是 macOS 官方推荐的包管理器，优势包括一键安装、自动配置环境变量、多版本隔离等。
前置检查
打开终端输入 brew -v。若显示版本号则已安装；若提示 command not found，需先执行官方安装脚本。
操作步骤
- 更新 Homebrew 源：
brew update
- 安装/升级 Python 3：
brew install python3
- 未安装过会直接安装最新版。
- 已安装旧版会自动升级并保留旧版本。
安装完成后，python3 将指向最新版，pip3 也会同步升级。
方案二：官网安装包（.pkg）升级 Python 3
适合不想使用 Homebrew 的用户，需手动配置环境变量。
步骤 1：下载安装包
访问 https://www.python.org/downloads/mac-osx/，下载 Latest Python 3 Release 对应的 macOS 64-bit universal2 installer。
步骤 2：安装
双击 .pkg 文件，按向导完成安装。路径通常为 /Library/Frameworks/Python.framework/Versions/3.13。
步骤 3：配置环境变量
确认终端类型（zsh 或 bash）：
echo $SHELL
- zsh：编辑
~/.zshrc - bash：编辑
~/.bash_profile
在文件末尾添加以下内容：
# 配置 Python 3.13 为默认版本
export PATH="/Library/Frameworks/Python.framework/Versions/3.13/bin:$PATH"
# 配置 pip3 指向 3.13
alias pip3="/Library/Frameworks/Python.framework/Versions/3.13/bin/pip3"
保存后执行 source ~/.zshrc 或 source ~/.bash_profile 使配置生效。
验证升级结果
依次执行以下命令确认：
- 查看版本：
python3 --version
应输出 Python 3.13.1。
2. 查看路径：
which python3
brew 安装输出 /usr/local/bin/python3，官网安装输出 /Library/Frameworks/...。
3. 查看 pip 版本：
pip3 --version
多版本管理与常用操作
升级后系统中可能共存 Python 2.7、3.8 和 3.13。
调用指定版本
直接使用带版本号的命令：
python→ 2.7python3→ 最新版 (3.13)python3.8→ 旧版python3.13→ 最新版
卸载旧版本
- Homebrew 安装：
brew uninstall [email protected]
- 官网安装包：
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.8
sudo rm -rf /usr/local/bin/python3.8
sudo rm -rf /usr/local/bin/pip3.8
升级 pip
python3 -m pip install --upgrade pip
虚拟环境创建
升级到新版 Python 3 后，虚拟环境创建命令不变：
cd /Users/你的用户名/你的项目路径
python3 -m venv venv
source venv/bin/activate
pip3 install pandas requests
python3 src/main.py
dedeactivate
常见问题与解决方案
-
python3 --version仍显示旧版本- 官网安装用户：重新执行
source ~/.zshrc。 - Homebrew 用户：执行
brew link --overwrite python3。
- 官网安装用户：重新执行
-
安装时提示
Permission denied- 避免使用
sudo pip3，改用pip3 install --user。
- 避免使用
-
python命令仍显示 2.7- 这是系统保护机制，习惯使用
python3调用新版本即可。
- 这是系统保护机制，习惯使用
