macOS 升级 Python 3 环境指南：保留系统 Python 2.7

• 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 使配置生效。

验证升级结果

依次执行以下命令确认：

1. 查看版本：

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.7
• python3 → 最新版 (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

常见问题与解决方案

1. python3 --version 仍显示旧版本

   • 官网安装用户：重新执行 source ~/.zshrc。
   • Homebrew 用户：执行 brew link --overwrite python3。

2. 安装时提示 Permission denied

   • 避免使用 sudo pip3，改用 pip3 install --user。

3. python 命令仍显示 2.7

   • 这是系统保护机制，习惯使用 python3 调用新版本即可。