VS Code下Python自动导入路径含冗余src问题解决求助

问题场景 #

工作区文件夹结构：

workspaceFolder
  subproject1
    src
      subproject1
        # 包含待导入的模块（如bla.py）
  subproject2
    src
      subproject2
  etc..

VS Code自动导入建议路径为from subproject1.src.subproject1.bla import bla，但期望路径是from subproject1.bla import bla，手动输入期望路径可正常识别。已配置.env的PYTHONPATH及VS Code相关设置，但问题未解决。

解决步骤 #

1. 修正.env中的PYTHONPATH配置 #

当前.env中的路径重复且格式存在问题，将其修改为包含各子项目src目录的路径：

• Windows系统：

  PYTHONPATH="${workspaceFolder}/subproject1/src;${workspaceFolder}/subproject2/src"
  

• Linux/macOS系统：

  PYTHONPATH="${workspaceFolder}/subproject1/src:${workspaceFolder}/subproject2/src"
  

该配置让Python直接将src目录作为包搜索路径，从而可以直接导入src下的subproject1包。

2. 为子项目包添加__init__.py #

在subproject1/src/subproject1和subproject2/src/subproject2目录下创建空的__init__.py文件，Python会将这些目录识别为合法的可导入包，帮助VS Code分析器正确识别包结构。

3. 配置VS Code的python.analysis.extraPaths #

在settings.json中添加以下配置，直接告知Pylance分析器额外的包搜索路径：

"python.analysis.extraPaths": [
    "${workspaceFolder}/subproject1/src",
    "${workspaceFolder}/subproject2/src"
]

该配置与PYTHONPATH形成互补，确保VS Code的自动补全模块能正确定位包的位置。

4. 重启VS Code并加载新配置 #

修改完成后，重启VS Code或按下Ctrl+Shift+P选择「Reload Window」，让所有新配置生效。

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