MacBook上VS Code终端与命令提示符Python版本不一致求助

版本混乱的核心原因 #

MacOS的Python环境本身存在多版本共存的设计，加上第三方工具安装的版本，就会出现不同命令指向不同版本的情况：

• python --version显示2.7.16：这是MacOS原生预装的Python2，系统默认将python命令绑定到该版本，目的是兼容依赖Python2的系统内置工具，苹果至今没有移除这个默认绑定。
• python3 --version显示3.7.7：这个版本大概率是你之前通过系统更新、App Store或早期Homebrew安装的Python3，系统的python3命令默认指向这个已存在的安装包。
• 命令提示符显示3.11.2：说明你已经通过Homebrew、pyenv或conda等工具安装了Python3.11.2，但该版本的环境变量没有在当前VS Code终端中生效——要么是VS Code终端未加载shell配置文件（如~/.zshrc或~/.bash_profile），要么你没将3.11.2设为全局默认版本。

快速排查与解决步骤 #

1. 确认各命令的实际路径
   运行以下命令查看每个Python命令对应的安装位置：

   which python
   which python3
   which python3.11
   

   输出的路径会帮你明确每个版本的来源（系统路径/brew路径/pyenv路径）。

2. 根据安装工具调整默认版本

   • 如果用Homebrew安装的3.11.2：
     执行命令将python3指向最新版本：

     brew link python3 --overwrite
     

     然后在shell配置文件（如~/.zshrc）中添加别名，让python也指向Python3.11.2（注意：不建议直接修改系统python命令，用别名更安全）：

     alias python='python3'
     

     保存配置后执行source ~/.zshrc生效，重启VS Code终端即可。

   • 如果用pyenv管理版本：
     将3.11.2设为全局默认版本：

     pyenv global 3.11.2
     

     确保shell配置文件中存在pyenv初始化代码：

     eval "$(pyenv init -)"
     

     同样执行source ~/.zshrc并重启VS Code终端。

3. 检查VS Code终端配置
   打开VS Code设置，确认终端使用的shell是你日常使用的类型（如zsh），而非默认的sh——sh不会加载用户自定义的配置文件，导致新安装的Python版本无法生效。

内容的提问来源于stack exchange，提问作者Lee