问题背景 #

• 环境信息：

  VSCode 1.103.2 (Win10)
  Ubuntu 20.04 (WSL2)
  Jedi 0.19.2
  Python扩展 2025.2.0
  虚拟环境Python 3.11.2
  

• 目录结构：

  A/
  ├── __init__.py
  ├── a.py
  ├── a1.py
  └── B/
      ├── __init__.py
      └── b.py
  

• 核心问题：
  A作为VSCode工作区根目录时，a.py中import A或from A import ...无法被Jedi解析，无法进行代码跳转；但b.py中import B功能正常。将A的父目录设为工作区根后恢复正常，且虚拟环境sys.path已包含A目录及其父路径。偏好Jedi轻量特性，不使用Pylance的解决方案。

可行解决方案 #

1. 配置VSCode Jedi额外搜索路径

在工作区的.vscode/settings.json中添加Jedi专属的路径配置，强制将当前工作区根纳入模块搜索范围：

{
  "python.jedi.extraPaths": ["${workspaceFolder}"]
}

保存配置后重启VSCode窗口，Jedi即可正确识别A作为顶层模块。

2. 通过.env文件全局调整PYTHONPATH

在A目录下创建.env文件，写入以下内容：

PYTHONPATH=${PYTHONPATH}:${workspaceFolder}

VSCode Python扩展会自动加载该文件，修正Jedi使用的路径环境，确保A目录被识别为合法的模块根。

3. 验证路径配置有效性

若上述方案无效，可在a.py中临时添加代码，打印Jedi实际使用的路径列表，排查是否存在路径缺失：

import sys
print(sys.path)

确认路径无误后，执行Ctrl+Shift+P -> Reload Window重启VSCode窗口，刷新Jedi的缓存。

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