You need to enable JavaScript to run this app. VSCode已配置正确解释器且安装依赖仍报ModuleNotFoundError
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 01:36:04