Visual Studio Code中Pylance配置Python搜索目录解决依赖报错问题

可以通过放置配置文件指定Pylance的Python搜索路径解决该问题，无需拆分打开子目录，以下是两种常用方案：

方法1：VSCode工作区专属配置 #

在项目根目录新建.vscode/settings.json文件（如果已经存在则直接修改），添加python.analysis.extraPaths配置项，填入所有需要加入搜索路径的目录，支持相对路径（相对项目根目录）。

举个例子，你的项目结构如下：

项目根目录
├── 子项目1/
├── 子项目2/
├── 公共代码库/
└── .vscode/
└── settings.json

对应的配置内容为：

{
  "python.analysis.extraPaths": [
    "./公共代码库",
    "./子项目1",
    "./子项目2"
  ]
}

该配置仅对当前VSCode工作区生效，不会修改系统或Python运行时的路径逻辑，和你实际生产运行的路径配置互不冲突。

方法2：通用Python静态分析配置 #

如果希望配置不绑定VSCode，可在项目根目录新建pyrightconfig.json文件，Pylance底层基于Pyright实现，会自动识别该配置：

{
  "extraPaths": [
    "./公共代码库",
    "./子项目1",
    "./子项目2"
  ]
}

该配置对所有基于Pyright的静态分析工具生效，适合多人协作的项目统一配置。

注意事项 #

• 路径填写支持通配符，也可根据实际需求调整层级
• 若配置保存后未立即生效，按下Ctrl+Shift+P（Mac系统为Command+Shift+P）执行Python: Restart Language Server命令重启Pylance即可
• 请先确认VSCode已经选中了项目对应的Python解释器（含虚拟环境），避免基础三方库识别错误

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