VS Code Python虚拟环境已装模块仍报ModuleNotFoundError如何解决

90%以上的同类问题都是VS Code运行代码时调用的Python解释器，和你装包的虚拟环境不是同一个，按以下顺序排查即可：

1. 先修正VS Code的Python解释器选择 #

终端手动执行activate脚本只对当前终端窗口生效，不会自动修改VS Code运行代码时调用的解释器：

• 按快捷键Ctrl+Shift+P（Windows/Linux）/Cmd+Shift+P（macOS）调出命令面板，输入Python: Select Interpreter回车
• 在弹出的解释器列表中，选择路径指向你创建的venv目录下的可执行文件：Windows系统对应./venv/Scripts/python.exe，macOS/Linux对应./venv/bin/python，不要选全局安装的Python 3.8.10或者其他版本的解释器
• 选中后查看VS Code窗口右下角状态栏，会显示当前生效的解释器路径，确认路径在venv目录下之后，再重新运行代码测试。

2. 排除pip安装路径不匹配的问题 #

如果系统里装了多个Python版本，哪怕激活了虚拟环境，pip3也有可能因为路径优先级问题把包装到其他环境里：

• 在已经激活venv的终端里，执行where python（Windows）/which python3（macOS/Linux），确认输出的第一个路径是venv目录下的Python可执行文件
• 不要用pip3 install的方式装包，换用解释器直调pip的方式安装，能100%保证包装到当前解释器对应的环境里：

  # Windows下执行
  .\venv\Scripts\python.exe -m pip install pandas requests
  # macOS/Linux下执行
  ./venv/bin/python -m pip install pandas requests
  

3. 检查运行配置的特殊问题 #

• 如果你安装了Code Runner插件，它默认不会读取VS Code选中的Python解释器配置，要么在Code Runner的设置项里把Python执行路径修改为venv下的Python路径，要么直接用VS Code官方Python插件提供的运行按钮（编辑器右上角带Python标识的三角形按钮）运行代码，不要点Code Runner的运行按钮。
• 关闭所有已经打开的终端窗口，新建终端后看命令行前缀有没有(venv)标识，如果没有，打开VS Code设置搜索python.terminal.activateEnvironment，勾选该选项，让新建终端自动激活当前选中的虚拟环境。

4. 最终验证 #

新建临时测试文件，写入以下代码运行：

import sys
print("当前运行代码的Python路径：", sys.executable)

import pandas
import requests
print("所有模块导入成功")

如果第一行输出的路径在你的venv目录下，且没有报导入错误，说明问题已经解决。

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