macOS Big Sur下Python3.7升级3.9 版本异常及包保留问题
问题核心原因
- 版本错配的根源并不是别名直接导致。你执行
python3 --version仍然显示3.7,本质是Homebrew安装完Python3.9之后没有完成软链接绑定,/usr/local/bin路径下原先留存的Python3.7可执行文件优先级更高,系统自然会优先匹配到旧版本。 - 你执行
brew link python3时报的Could not symlink bin/2to3错误,就是最直接的印证:旧的Python3.7已经占用了/usr/local/bin下的一批可执行文件软链接,Homebrew没法直接覆盖这些现有文件完成3.9的绑定,自然没法切换默认版本指向。
分步操作指南
1. 安全完成Python3.9的链接绑定
- 先做预检查,避免误删非Python相关的文件:执行
brew link --overwrite --dry-run python@3.9
这个命令仅会列出所有会被替换的冲突文件列表,不会实际执行删除或修改操作。核对列表内的文件均为Python相关的可执行文件后再继续操作,避免覆盖其他软件生成的同名命令。 - 确认无风险后,执行强制覆盖链接命令:
brew link --overwrite python@3.9 - 链接完成后验证版本:执行
python3 --version,如果输出对应3.9.x版本,说明绑定成功。
2. Python3.7已装包的保留说明
- 两个版本的包存储路径完全独立,不存在“需要把3.7的包迁到3.9才能保留”的问题:Homebrew安装的Python会把不同版本的包分别存储在
/usr/local/lib/python3.7/site-packages和/usr/local/lib/python3.9/site-packages路径下,你正常操作不会修改3.7路径下的任何已安装包,所有旧包都会原封不动留存。后续需要调用3.7跑旧项目时,直接指定/usr/local/bin/python3.7路径启动即可。 - 如果你确实需要在3.9环境下复用3.7的包列表,无需逐个手动安装,可通过pip导出导入完成批量同步:
- 从Python3.7导出已安装包清单:
/usr/local/bin/python3.7 -m pip freeze > requirements.txt - 在Python3.9环境下批量安装清单内的包:
python3.9 -m pip install -r requirements.txt
同步过程中出现的版本兼容类报错,完全不影响3.7环境的包存储。
- 从Python3.7导出已安装包清单:
3. 安全卸载旧Python3.7、保留3.9的操作
- 确认当前默认
python3已经切换到3.9版本后,先排查Python3.7的安装来源,不要上来就手动删除文件:- 执行
brew list | grep python查看Homebrew管理的Python包列表,如果能看到单独的python@3.7条目,直接执行brew uninstall python@3.7即可,Homebrew会自动清理对应版本的软链接、缓存文件,不会触碰3.9的相关文件。 - 如果Python3.7不是通过Homebrew安装(比如是Python官网的pkg安装包),直接通过安装时附带的官方卸载脚本完成清理即可,操作过程中注意不要误删
/usr/local/bin/python3指向3.9的软链接。
- 执行
4. 别名问题的补充排查
如果完成链接绑定后,执行python3 --version仍然显示3.7版本,再去检查shell配置的别名即可,不需要一开始就改动配置:
- 对应zsh用户打开
~/.zshrc,bash用户打开~/.bash_profile,搜索是否存在alias python3=/usr/local/bin/python3.7这类强制指向旧版本的别名配置,找到后删除该行,保存配置后执行source ~/.zshrc(bash用户执行对应配置文件的source命令)让配置生效即可。
内容的提问来源于stack exchange,提问作者The Singularity
相关产品推荐
相关产品推荐

