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调用新版本即可。
- 这是系统保护机制,习惯使用

