如何配置VS Code实现工作区多仓库Python模块跨目录解析

针对在VS Code中加载多个代码仓库，需要让repo1的including_script.py识别repo2/src下包结构并获得代码提示的问题，给出以下解决思路：

• 检查.env文件配置有效性

  • 确保.env文件内的PYTHONPATH配置为repo2/src的绝对路径，Windows系统注意路径分隔符用正斜杠或双反斜杠，格式示例：

    PYTHONPATH=/Users/xxx/repo2/src
    # Windows示例
    PYTHONPATH=C:/Users/xxx/repo2/src
    

  • 确认.env文件放置在repo1根目录，且VS Code的Python插件已正确读取该文件：可通过设置搜索python.envFile，确认路径指向${workspaceFolder}/repo1/.env

• 配置工作区settings.json
  在工作区的.vscode/settings.json中添加额外路径配置，让Python分析器明确识别repo2的源码目录：

  {
      "python.analysis.extraPaths": [
          "${workspaceFolder}/repo2/src"
      ],
      "python.envFile": "${workspaceFolder}/repo1/.env"
  }
  

  这里使用${workspaceFolder}相对路径，适配不同环境或协作场景

• 确认Python解释器选择正确
  确保VS Code右下角选中的是repo1的venv虚拟环境解释器，代码提示依赖当前选中的解释器的环境配置，全局解释器可能无法读取repo1的.env文件

• 重启Python语言服务
  配置修改后，按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行命令Python: Restart Language Server，让新配置生效

• 检查包结构完整性
  在repo2/src下的mypackage和mysubpackage目录中添加空的__init__.py文件，虽然Python 3.3+支持无__init__.py的命名空间包，但VS Code的代码分析器通常需要该文件才能正确识别包层级关系

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