VS Code调试多模块Maven项目时无法获取依赖模块源码求助

架构老林

2026-8-11

解决方案

确保依赖模块编译时生成调试信息
在依赖模块的pom.xml中，给maven-compiler-plugin添加调试参数，保证编译后的class文件包含行号、变量等调试关联信息：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
        <source>1.8</source> <!-- 替换为你实际使用的JDK版本 -->
        <target>1.8</target>
        <debug>true</debug>
        <debuglevel>lines,vars,source</debuglevel>
      </configuration>
    </plugin>
  </plugins>
</build>
执行`mvn clean install`重新编译安装依赖模块。

手动关联依赖模块源码
打开VS Code的「Java: Show Java Dependencies」视图，找到目标依赖模块，右键选择「Attach Source」，手动指定该模块的源码根目录（如dependency-module/src/main/java）或已生成的源码JAR文件。

修正launch.json的sourcePaths配置
sourcePaths需指向依赖模块的源码根目录而非源码JAR，示例配置如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Debug Main Module",
      "request": "launch",
      "mainClass": "com.yourpackage.MainClass",
      "projectName": "main-module",
      "sourcePaths": [
        "${workspaceFolder}/dependency-module/src/main/java"
      ]
    }
  ]
}
替换`dependency-module`为实际的依赖模块名称。

清理Java语言服务器缓存
按Ctrl+Shift+P打开命令面板，执行「Java: Clean Java Language Server Workspace」，之后重启VS Code重新加载项目。
确认依赖模块已加入工作区
如果依赖模块是独立项目，通过「File > Add Folder to Workspace」将其加入当前VS Code工作区，确保调试器能直接访问源码文件而非仅本地仓库的编译产物。
检查调试基础设置
在VS Code设置中搜索java.debug.settings，确认java.debug.settings.enableSourceLookup设置为true（默认开启），避免源码查找功能被意外关闭。