Mac下VSCode终端调用错误Python版本导致requests库导入失败求助

1. 修复VSCode内置终端Python版本不匹配问题 #

VSCode内置终端默认不会完全继承系统终端的PATH配置，是版本不匹配的核心原因，按以下顺序操作：

• 先在VSCode内置终端执行which python3，确认当前默认Python3的路径：
  • 若输出为/usr/bin/python3，说明调用的是系统自带Python
  • 若输出为/opt/homebrew/bin/python3（M系列Mac）或/usr/local/bin/python3（Intel系列Mac），说明调用的是Homebrew安装的Python
• 打开VSCode设置（快捷键Cmd + ,），搜索terminal.integrated.inheritEnv，勾选该选项，让终端继承系统的PATH配置
• 继续搜索python.terminal.activateEnvironment，勾选该选项，打开终端时会自动激活你在Python插件中选定的解释器环境
• 若以上操作后版本仍不对，打开系统终端编辑shell配置文件（用zsh的话编辑~/.zshrc，用bash的话编辑~/.bash_profile），添加别名：

  alias python3="/opt/homebrew/bin/python3.9" # M系列Mac填这个，Intel系列替换为/usr/local/bin/python3.9
  alias pip3="/opt/homebrew/bin/pip3.9" # 同上对应修改路径
  

  保存后执行source ~/.zshrc（对应bash的话执行source ~/.bash_profile），重启VSCode即可生效。

2. 修复Pylance报requests模块缺失问题 #

该报错的核心原因是requests库被安装到了系统自带Python3.8的依赖目录，而你选定的Homebrew Python3.9环境中没有该库，按以下步骤操作：

• 先点击VSCode左下角显示的Python版本号，复制你选定的Homebrew Python3.9的完整路径，示例路径为/opt/homebrew/bin/python3.9
• 在VSCode内置终端执行以下命令，明确将requests安装到指定的Python环境中：

  /opt/homebrew/bin/python3.9 -m pip install requests
  

  注意把命令中的路径替换为你刚才复制的实际路径
• 若仍有报错，执行以下命令获取当前Python环境的依赖包目录路径：

  /opt/homebrew/bin/python3.9 -c "import site; print(site.getsitepackages()[0])"
  

  复制输出的路径，打开VSCode设置搜索python.analysis.extraPaths，点击「添加项」把刚才复制的路径粘贴进去，保存后按Cmd + Shift + P呼出命令面板，输入「Reload Window」重载VSCode窗口即可。

校验操作 #

完成以上步骤后在VSCode内置终端执行以下命令，确认配置生效：

• 执行python3 --version，输出应为3.9.7
• 执行python3 -c "import requests; print(requests.__version__)"，无报错且正常输出版本号即为配置完成。

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