Python 多版本冲突解决记录

Python 多版本冲突解决记录最近遇到一个 Python 版本冲突问题一开始我手动安装了 Python 3.14最新版本但是在启动一些项目时出现兼容性问题因此想切换到 Python 3.11。于是通过 Homebrew 安装brewinstallpython3.11但是安装完成后在终端查询 Python 版本时发现一直显示的是 Python 3.14。期间也尝试让 DeepSeek 解决这个问题给出的方案主要集中在修改环境变量PATH但是反复修改后仍然没有解决。最终通过 OpenAI 定位到了真正原因不是简单的环境变量问题而是当前 python3 命令实际指向的位置问题。下面记录一下解决过程。第一步先确认 Python 3.14 到底来自哪里关键先执行which-apython3which-apython python3-cimport sys; print(sys.executable)然后继续执行ls-l$(whichpython3)你大概率会看到类似结果情况 A最常见/Library/Frameworks/Python.framework/Versions/3.14/bin/python3说明当前使用的是 python.org 官网安装包安装的 Python 3.14。这种情况下即使安装了 Homebrew 的 Python 3.11系统仍然优先找到 Python 3.14。情况 B/opt/homebrew/bin/python3说明当前使用的是 Homebrew 安装的 Python但是版本没有切换到 3.11。第二步根据安装来源进行处理情况 APython 3.14 来自 python.org 安装包如果确认是/Library/Frameworks/Python.framework/Versions/3.14可以直接删除 Python 3.14sudorm-rf/Library/Frameworks/Python.framework/Versions/3.14然后清理可能存在的软链接sudorm-f/usr/local/bin/python3sudorm-f/usr/local/bin/pip3刷新 Shellhash-rexeczsh重新检查python3--version情况 BPython 3.14 是 Homebrew 安装的先确认 Homebrew 当前安装的 Pythonbrew list|greppython如果看到python3.14执行brew uninstall python3.14然后切换到 Python 3.11brew unlink python brew unlink python3.142/dev/null brewlinkpython3.11--force--overwrite最后重新检查python3--version总结这次问题的核心不是 Python 3.11 没安装而是终端中的python3命令仍然指向 Python 3.14 的安装路径。解决多版本 Python 冲突时不要第一时间修改 PATH应该先确认which-apython3 python3-cimport sys; print(sys.executable)看当前 Python 实际来源再决定卸载、unlink 或重新 link。