激活venv后使用VS Code调试器仍提示‘ModuleNotFoundError: No module named 'streamlit'’问题求助

我完全懂你的困扰——明明终端激活虚拟环境后能正常跑streamlit run app.py，但调试器就是找不到模块，哪怕已经选对了解释器、折腾了launch.json各种配置。这种情况往往是VS Code调试器没正确继承虚拟环境的运行上下文，下面是几个针对性的排查和解决方法：

• 强制指定launch.json中的Python绝对路径
  有时候VS Code状态栏显示的解释器和调试器实际调用的路径并不一致，尤其是当你有多个虚拟环境或系统Python时。打开.vscode/launch.json，把python字段改成虚拟环境中Python的绝对路径：

  • Linux/macOS："python": "${workspaceFolder}/venv/bin/python"
  • Windows："python": "${workspaceFolder}\\venv\\Scripts\\python.exe"
    确保调试器精准调用项目专属虚拟环境，示例配置如下：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Streamlit Debug",
              "type": "python",
              "request": "launch",
              "program": "${workspaceFolder}/app.py",
              "python": "${workspaceFolder}/venv/bin/python",
              "args": [],
              "console": "integratedTerminal"
          }
      ]
  }
  

• 让调试器继承虚拟环境的环境变量
  虚拟环境激活后会修改PYTHONPATH等环境变量，但调试器可能不会自动继承这些临时配置。在launch.json中添加env字段，手动指定PYTHONPATH为你的工作区目录：

  "env": {
      "PYTHONPATH": "${workspaceFolder}"
  }
  

  如果你的项目有.env配置文件，也可以通过envFile字段直接加载：

  "envFile": "${workspaceFolder}/.env"
  

• 检查工作区设置是否存在冲突
  打开VS Code设置（快捷键Ctrl+,），搜索python.pythonPath，确认该配置指向的是项目虚拟环境中的Python路径，而非系统Python或其他环境。如果之前有错误配置，修改后记得保存并重启VS Code。

• 重启Python语言服务器清除缓存
  有时候VS Code的Python语言服务器会缓存旧的环境信息，导致调试器识别出错。按下Ctrl+Shift+P，输入Python: Restart Language Server，等待服务器重启后再尝试调试。

• 验证虚拟环境路径一致性
  在激活虚拟环境的终端中运行which python（Linux/macOS）或where python（Windows），复制输出的绝对路径替换到launch.json的python字段中，确保调试器和终端使用的是同一个Python解释器。

为什么会出现这种问题？简单来说，终端激活虚拟环境是通过临时修改环境变量实现的，但VS Code调试器运行时可能不会完全继承这些临时变量——哪怕状态栏显示你选对了解释器，调试器仍可能因为配置优先级或缓存问题，调用了错误的Python环境。通过上述步骤强制绑定虚拟环境的绝对路径和环境变量，就能解决这个矛盾。

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