macOS下多Python版本冲突导致模块无法导入问题求助

1. 修复pyenv环境生效问题 #

pyenv切换版本无效果，多数是shell初始化配置缺失，按以下步骤操作：

• 打开终端，检查zsh配置是否包含pyenv初始化代码：

  cat ~/.zshrc | grep pyenv
  

• 如果无输出，执行以下命令添加配置（默认shell为zsh，bash用户替换为.bash_profile）：

  echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
  echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
  echo 'eval "$(pyenv init -)"' >> ~/.zshrc
  

• 重启终端或执行source ~/.zshrc，输入pyenv version确认当前版本为3.11.1。

2. 彻底切换并验证Python 3.11.1 #

• 设置全局默认版本：

  pyenv global 3.11.1
  

• 若仅需当前项目使用该版本，在项目根目录执行：

  pyenv local 3.11.1
  

• 验证版本一致性：

  python --version  # 应显示Python 3.11.1
  pip --version     # 应对应Python 3.11.x
  

  注：使用pyenv后，直接用python和pip即可，无需加3后缀。

3. 正确安装模块到目标版本 #

之前的模块安装到了系统Python 3.9，切换到3.11后需重新安装：

pip install fastapi

4. 配置VS Code使用pyenv管理的Python解释器 #

• 打开VS Code，按下Cmd+Shift+P，输入Python: Select Interpreter
• 在列表中选择路径为~/.pyenv/versions/3.11.1/bin/python的选项
• （可选）在项目根目录创建.vscode/settings.json，锁定解释器路径：

  {
    "python.pythonPath": "/Users/你的用户名/.pyenv/versions/3.11.1/bin/python"
  }
  

  替换你的用户名为实际系统用户名。

5. 清理多余Python版本（可选） #

• 用pyenv删除非系统依赖的版本：

  pyenv uninstall 3.10.8  # 替换为你要删除的版本号
  

• 注意：macOS自带的Python 3.9不建议删除，系统部分功能可能依赖它，仅需通过pyenv覆盖全局版本即可。

验证测试 #

完成上述步骤后，在终端和VS Code分别测试：
终端执行：

from fastapi import FastAPI
app = FastAPI()
print("FastAPI导入成功")

VS Code运行你的示例代码，应不再出现ModuleNotFoundError: No module named 'fastapi'错误。

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