Monorepo多虚拟环境下Pyright跨项目导入报错的配置方案问询

问题背景 #

Monorepo结构中，project1的main.py导入library模块时，Pyright触发reportMissingImports错误，但代码实际可运行。手动指定pythonpath能临时解决，但多项目各有独立.venv，无法全局统一设置，需要适配多虚拟环境的配置方案，目标是让Sublime Text 3的LSP-pyright正常工作，支持Python>=3.11。

具体配置步骤 #

1. 给每个项目单独配置pyrightconfig.json #

以project1为例，在project1/根目录下创建pyrightconfig.json文件，内容如下：

{
  "include": ["src/**/*"],
  "exclude": ["**/__pycache__", ".venv"],
  "pythonPath": ".venv/bin/python",
  "extraPaths": ["../library/src"],
  "reportMissingImports": true,
  "pythonVersion": "3.11"
}

• pythonPath：直接指向当前项目Poetry虚拟环境的Python解释器，用相对路径即可（相对于该配置文件所在目录）
• extraPaths：添加library的src目录，让Pyright能识别跨项目的模块导入
• pythonVersion：明确指定项目使用的Python版本，确保适配3.11及以上版本

其他项目（比如project2）同理，复制该配置文件后，修改pythonPath为自身虚拟环境路径，extraPaths按需添加依赖的库目录。

2. 确保每个项目的虚拟环境正确生成 #

进入每个项目目录，执行：

poetry install

生成对应的.venv目录，保证pyrightconfig.json里的pythonPath路径和实际虚拟环境路径一致。

3. 调整Sublime Text 3的LSP-pyright设置 #

打开Sublime的设置面板：Preferences > Package Settings > LSP > Servers > LSP-pyright，添加以下配置：

{
  "settings": {
    "python.analysis.autoSearchPaths": true,
    "python.analysis.useLibraryCodeForTypes": true
  }
}

这个配置会让LSP-pyright自动读取当前打开项目根目录的pyrightconfig.json，自动适配对应项目的虚拟环境和路径规则。

验证方式 #

打开project1的main.py，检查from library import ModuleClass语句是否还会触发reportMissingImports错误。如果仍有问题，可打开Sublime控制台（View > Show Console）查看LSP-pyright的日志，确认是否正确加载了项目的pyrightconfig.json文件。

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