修复单独打开worker子项目时Pylance无法解析上层目录导入的错误

问题根源 #

你运行代码时会自动将依赖目录加入运行时sys.path，因此代码可以正常执行，但Pylance静态分析时默认仅识别工作区范围内的路径，配置的extraPaths路径层级错误是最常见的报错原因。

分步修复方案 #

• 第一步：修正extraPaths路径配置
  你需要根据自己的导入写法调整路径，当前你单独打开worker作为VS Code工作区根目录时：
  • 如果你的导入语句为from config import xxx（直接导入app下的模块）：需要将app目录加入路径，对应相对路径为../，修改配置为：

    "python.analysis.extraPaths": ["../"],
    "python.autoComplete.extraPaths": ["../"]
    

  • 如果你的导入语句为from app.config import xxx（带app包名导入）：需要将大项目的根目录加入路径，对应相对路径为../../，修改配置为：

    "python.analysis.extraPaths": ["../../"],
    "python.autoComplete.extraPaths": ["../../"]
    

• 第二步：确认Python解释器选择正确
  点击VS Code右下角的Python版本号，选择worker项目对应的虚拟环境解释器，避免Pylance绑定到其他项目的解释器导致配置不生效。
• 第三步：重启语言服务生效配置
  按Ctrl+Shift+P（Mac系统为Cmd+Shift+P），依次执行以下两个命令：
  1. Python: Restart Language Server
  2. Developer: Reload Window
• 第四步：兜底兼容方案
  如果上述操作后仍报错，可以在worker项目根目录新增.env文件，写入以下内容：

  PYTHONPATH=../../ # 按需替换为你对应的目标目录相对路径
  

  再在worker的.vscode/settings.json中新增一行配置：

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

  重启窗口后Pylance会自动读取PYTHONPATH配置识别导入路径。

内容的提问来源于stack exchange，提问作者Sami Al-Subhi