You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VS Code使用venv调试Python出现module not found报错如何解决

问题解决方法
  • 第一步:确认VSCode使用的Python解释器为项目venv环境对应的解释器
    按下Ctrl+Shift+P(Windows系统)/Cmd+Shift+P(Mac系统)调出命令面板,搜索并选择「Python: 选择解释器」,在列表中选中当前项目下.venv\Scripts\python.exe(Windows)或.venv/bin/python(Linux/Mac)路径的解释器即可。
  • 第二步:修正launch.json配置
    你当前配置中手动指定的PYTHONPATH仅包含工作区根目录,覆盖了默认的第三方包搜索路径,导致venv内安装的依赖无法被识别,有两种修正方案:
    1. 直接删除配置中的"env": { "PYTHONPATH": "${workspaceRoot}"}这一行,默认配置会自动包含venv的第三方包搜索路径,无需手动指定
    2. 若确实需要保留自定义PYTHONPATH配置,补充venv的site-packages路径即可,Windows系统下修改为:
    "env": { 
        "PYTHONPATH": "${workspaceRoot};${workspaceRoot}/.venv/Lib/site-packages"
    }
    
    Linux/Mac系统下分隔符替换为冒号即可:
    "env": { 
        "PYTHONPATH": "${workspaceRoot}:${workspaceRoot}/.venv/lib/python<你的Python版本号>/site-packages"
    }
    
  • 第三步:验证依赖安装情况
    激活项目venv后执行pip list,检查返回列表中是否存在simplipy,避免出现终端使用其他环境的Python、venv内未实际安装依赖的情况。
  • 第四步:重载VSCode配置
    上述操作完成后如果仍报错,按下Ctrl+Shift+P调出命令面板,搜索「开发者: 重新加载窗口」,重启VSCode窗口后再尝试调试即可。

内容的提问来源于stack exchange,提问作者petercli

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.05 21:42:03