Windows10下VSCode虚拟环境Python本地模块导入失败求助

为什么虚拟环境的sys.path里会出现全局Python的路径？ #

这是正常现象。虚拟环境的Python解释器依赖全局Python的核心库（比如标准库、DLL文件），这些路径是解释器运行必需的，虚拟环境仅隔离site-packages目录（第三方包的安装位置），核心组件会复用全局Python的资源，所以这些路径出现在sys.path里无需担心。

解决"Module not found"错误的步骤 #

• 确认模块的实际安装位置
  在激活的虚拟环境终端中执行：

  pip show <你的模块名>
  

  查看输出中的Location字段，确认是否指向虚拟环境的site-packages（即C:\Users\User\Documents\mednotes\.venv\lib\site-packages）。如果不是，说明安装时未正确使用虚拟环境的pip，需重新激活环境后执行pip install <模块名>重新安装。

• 核对VSCode的Python解释器选择
  虽然终端已激活虚拟环境，但VSCode编辑器可能仍关联全局Python。点击左下角状态栏的Python版本标识，选择.venv\Scripts\python.exe作为当前工作区的解释器，确保运行/调试时使用该解释器。

• 检查自定义本地模块的结构与路径
  如果是你自己编写的本地模块（而非通过pip安装的包）：

  1. 确保模块所在目录被添加到sys.path（比如模块在mednotes/src下，需将C:\Users\User\Documents\mednotes加入sys.path）；
  2. 模块目录下建议创建空的__init__.py文件（Python 3.3+虽可选，但能帮助VSCode更准确识别模块）。

• 验证终端的Python路径优先级
  在激活的虚拟环境终端中执行：

  where python
  

  确认输出的第一个路径是虚拟环境的.venv\Scripts\python.exe。如果全局Python路径排在前面，说明环境变量配置有问题，可关闭终端重新激活虚拟环境，或检查系统环境变量中Path的顺序。

• 清除VSCode的解释器缓存
  按Ctrl+Shift+P打开命令面板，输入Python: Clear Workspace Interpreter Cache执行，随后重新选择虚拟环境解释器，解决IntelliSense缓存导致的识别问题。

• 排查命名冲突
  确认你的模块名称未与Python标准库、已安装的第三方包重名（比如不要把自己的脚本命名为requests.py），否则会导致导入时优先加载同名的本地文件，引发错误。

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