VSCode已配置正确解释器且安装依赖仍报ModuleNotFoundError
VSCode 配置虚拟环境后仍报模块缺失的排查方案
核心触发原因
你按下Ctrl+Alt+N触发的是Code Runner插件的运行逻辑,该插件不会自动同步Python插件的解释器选择配置,默认调用系统全局Python解释器执行代码。哪怕你在解释器选择器里指定了虚拟环境、终端里能通过pip list查到已安装的目标库,运行代码时依然会走全局环境路径查找模块,自然触发ModuleNotFoundError报错。
逐步骤排查修正操作
- 修正Code Runner的执行路径配置
打开VSCode设置(快捷键Ctrl+,),搜索配置项code-runner.executorMap,定位到python对应的执行规则,将默认的python -u替换为你虚拟环境的解释器路径,示例配置为.venv\Scripts\python.exe -u,确保Code Runner运行代码时直接调用虚拟环境的解释器,而非系统全局Python。 - 开启Code Runner的集成终端运行开关
在VSCode设置中搜索code-runner.runInTerminal,勾选该选项。开启后Code Runner的运行逻辑会复用当前VSCode已激活的终端环境状态,不会在独立的隔离进程中运行代码,避免虚拟环境激活状态不生效的问题。 - 校验解释器路径的实际匹配性
打开VSCode的输出面板,在顶部通道下拉菜单选择「Python」,查看插件启动时加载的解释器绝对路径,和你在终端执行where python(Windows系统)得到的虚拟环境路径做比对:如果两者路径不一致,说明VSCode存在旧的解释器缓存,需要重新打开「Select Interpreter」面板,手动选择
.venv目录下的Scripts/python.exe条目,不要选择带缓存标记的旧路径。 - 清理冗余终端会话状态
关闭所有已打开的旧终端窗口,重新新建一个终端,手动执行.venv\scripts\activate确认虚拟环境激活(终端行首出现(.venv)标识)后再触发代码运行,避免VSCode将运行输出绑定到之前激活了全局Python的旧终端会话。
替代运行方案
如果不需要用Code Runner的自定义运行逻辑,可以直接使用Python插件自带的「Run Python File」按钮(代码块上方的三角形运行标识),该按钮完全同步解释器选择器的配置,不会出现路径不匹配的问题。
内容的提问来源于stack exchange,提问作者simvee
相关产品推荐
相关产品推荐

