如何配置VS Code Pylance适配Bazel Python工具链并实现智能感知

针对你的Bazel Python项目，要让Pylance同时识别内部包（如packageA）和Bazel管理的外部依赖（如NumPy），可以按以下步骤配置：

一、让Pylance识别内部包 #

在项目根目录的.vscode/settings.json中添加python.analysis.extraPaths，将src目录纳入Pylance的扫描范围：

{
  "python.analysis.extraPaths": [
    "${workspaceFolder}/src"
  ]
}

这样Pylance就能找到src/packageA下的模块，为main.py中对packageA的引用提供智能感知。

二、让Pylance识别Bazel管理的外部依赖 #

Bazel的依赖是通过运行时PYTHONPATH注入的，需要将这些依赖路径同步给Pylance：

1. 用rules_python工具自动生成配置
   确保项目WORKSPACE文件已引入rules_python，执行以下Bazel命令：

   bazel run @rules_python//python/tools/generate_vscode_settings
   

   该命令会自动生成包含所有Bazel依赖路径的.vscode/settings.json，覆盖或补充原有配置，让Pylance能识别NumPy这类外部依赖。

2. 切换到Bazel工具链的Python解释器
   先获取Bazel使用的Python解释器路径：

   bazel run @python3//:python -- --version
   

   在VS Code中按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），选择「Python: Select Interpreter」，将解释器切换为上述命令输出的路径，确保Pylance使用和Bazel一致的Python环境。

3. 验证配置效果
   重启VS Code后，检查main.py中对NumPy和packageA的引用是否出现智能提示，比如代码补全、类型标注等。

补充方案（手动适配） #

如果自动生成工具失效，可以手动提取Bazel的依赖路径：
执行bazel build //scripts:main后，通过以下命令导出运行脚本：

bazel run //scripts:main --script_path=run_main.sh

查看run_main.sh中的PYTHONPATH变量，将其中的路径逐一添加到python.analysis.extraPaths中。不过这种方式维护成本较高，优先推荐自动生成工具。

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