VS Code多根工作区跳转定义指向Jar而非项目源码的问题求助

1. 修正配置语法错误 #

你的配置存在语法结构错误：java.project.sourcePaths被错误嵌套在java.project.referencedLibraries对象内部，导致VS Code无法正确识别本地源码路径。修正后的配置结构如下：

{
  "java.project.referencedLibraries": {
    "include": [
      "<absolute_path_to_dependency_project>/bazel-bin/*.jar",
      "<absolute_path_to_other_dependency>/bazel-bin/*.jar"
    ],
    "exclude": [
      "bazel-out",
      "bazel-testlogs",
      // 排除当前项目自身生成的Jar，避免和本地源码冲突
      "<absolute_path_to_current_project>/bazel-bin/*.jar"
    ],
    "sources": {
      "<absolute_path_to_dependency>.jar": "<absolute_path_to_dependency>-src.jar"
    }
  },
  "java.project.sourcePaths": [
    "src",
    "src/main/java",
    "java",
    "java/api",
    "java/impl"
  ]
}

2. 核心调整：排除当前项目的Bazel生成Jar #

语言服务优先选择Jar中的类定义，本质是因为你同时引用了当前项目自身的Bazel输出Jar和本地源码。必须排除当前项目的bazel-bin下的Jar——本地源码已经通过sourcePaths被索引，不需要再通过Jar引用自身代码。

如果是多项目工作区，可在.code-workspace文件中针对不同文件夹做差异化配置：

{
  "folders": [
    { "path": "project-a" },
    { "path": "project-b" }
  ],
  "settings": {
    "java.project.sourcePaths": [
      "src",
      "src/main/java"
    ],
    // 针对project-a排除自身的Bazel Jar
    "project-a.java.project.referencedLibraries.exclude": [
      "${workspaceFolder}/project-a/bazel-bin/*.jar"
    ],
    // 针对project-b排除自身的Bazel Jar
    "project-b.java.project.referencedLibraries.exclude": [
      "${workspaceFolder}/project-b/bazel-bin/*.jar"
    ]
  }
}

3. 强制语言服务重新索引本地源码 #

执行以下操作让语言服务优先识别本地源码：

• 按Ctrl+Shift+P，选择Java: Clean Java Language Server Workspace，清理缓存后重启VS Code；
• 确认所有本地源码目录在VS Code资源管理器中可见，且未被排除在工作区外。

4. 使用Bazel插件简化配置 #

安装VS Code的Bazel for Java插件，它会自动识别Bazel项目结构，生成正确的源码路径和依赖配置，避免手动配置的冲突，同时默认优先使用本地工作区源码进行跳转。

5. 验证效果 #

跳转定义前先确认：如果本地存在对应.java文件，语言服务应优先跳转至此；仅当本地无对应文件时，才会跳转到Bazel生成的Jar源码。

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