VS Code多Python包工作区IntelliSense失效问题求助

工作区包含两个开发中的Python包，结构如下：

• Package1
  • ClassA
• Package2
  • ClassB

Package2依赖Package1，已在Package2的虚拟环境中通过以下命令以严格可编辑模式安装Package1：

pip install -e c:\\users\\user\\GitLab\\modules --config-settings editable_mode=strict

出现的异常现象：

• 在ClassB中编辑后打开ClassA，Package1的IntelliSense、语法高亮会立即失效，文本变为白色，但Package2功能正常；仅单独查看Package1时无此问题，重启VS Code可恢复，但重复操作会复现。
• 若在Package2配置python.analysis.extraPaths指向Package1目录，会引发Package1代码解析异常，疑似命名空间冲突。
• 新建仅包含两个包的工作区后，从Package2中Ctrl+点击Package1的实体，会跳转到可编辑安装生成的C:\\Users\\user\\gitlab\\modules\\build\\__editable__.modules-0.0.5-py3-none-any\\...目录，该目录下的文件无法被解析；但从文件资源管理器手动打开Package1的源文件路径时，解析正常，重启Python语言服务器可临时恢复功能。

1. 配置工作区专属设置，锁定解析路径 #

在工作区的.code-workspace文件中添加如下配置，避免语言服务器混淆源文件与可编辑安装生成的代理文件：

{
  "folders": [
    {"path": "Package1"},
    {"path": "Package2"}
  ],
  "settings": {
    "python.analysis.autoSearchPaths": false,
    "python.analysis.extraPaths": [],
    "python.defaultInterpreterPath": "Package2/.venv/Scripts/python.exe",
    "python.analysis.packageIndexDepths": [{"name": "Package1", "depth": 2}]
  }
}

• 关闭autoSearchPaths防止语言服务器自动拾取build目录；
• 指定Package2的虚拟环境为默认解释器，确保依赖解析逻辑一致；
• 设置Package1的索引深度，让语言服务器正确识别源文件结构。

2. 改用宽松模式的可编辑安装 #

卸载现有Package1后，以默认宽松模式重新安装：

pip uninstall -y Package1
pip install -e c:\\users\\user\\GitLab\\modules

严格模式（editable_mode=strict）会生成代理文件指向源目录，容易导致VS Code语言服务器混淆路径；宽松模式下Python直接读取源文件目录，可减少此类冲突。

3. 排除build目录的解析 #

在工作区设置中添加规则，让语言服务器忽略自动生成的build目录：

"files.exclude": {"**/build": true},
"python.analysis.excludePaths": ["**/build/**"]

这样语言服务器不会解析build下的代理文件，避免与源文件的命名空间冲突。

4. 强制语言服务器重新索引源文件 #

1. 打开命令面板（Ctrl+Shift+P），执行Python: Select Interpreter，确认选中Package2的虚拟环境；
2. 再次打开命令面板，执行Python: Restart Language Server；
3. 手动打开Package1的源文件，触发语言服务器重新索引源目录而非build下的代理文件。

5. 检查Package1的打包配置 #

确保Package1的setup.py或pyproject.toml中排除build目录，避免打包配置干扰语言服务器解析：
例如在pyproject.toml中添加：

[tool.setuptools.package-data]
exclude = ["build/*"]

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