关键在于让IDE自动识别-sources.jar：需在pom.xml中配置maven-source-plugin（3.3.1+，attach=true，phase=verify），执行mvn clean install部署源码包至本地仓库，再在IDE中右键项目→Maven→Download Sources and Documentation，成功后External Libraries下对应jar应含src节点且Ctrl+Click可跳转真实源码。
Java Maven 项目中，源码关联调试的关键不是“手动找源码”，而是让 IDE 自动识别并加载 -sources.jar 文件。只要 Maven 正确生成、发布源码包，且 IDE 能定位到它，Ctrl+Click 就能跳转真实源码，而不是反编译的灰色代码。
确保 Maven 项目生成 source jar 包
这是整个流程的基础。没生成 -sources.jar，IDE 再怎么配置也无源可附。
- 在
pom.xml的<build><plugins>中添加maven-source-plugin，推荐使用 3.3.1 或更高稳定版 - 绑定执行时机：建议用
<phase>verify</phase>（而非package），因为deploy会依赖verify阶段产出，确保源码包在上传前已就位 - 必须开启
<attach>true</attach>，否则插件只生成 jar，不自动附加到构建产物中 - 完整配置示例：
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>3.3.1</version>
<configuration>
<attach>true</attach>
</configuration>
<executions>
<execution>
<id>attach-sources</id>
<phase>verify</phase>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
让源码包真正发布到仓库（本地或远程）
仅生成 -sources.jar 不够，它必须被安装或部署，IDE 才能在依赖解析时找到它。
- 执行
mvn clean install：把-sources.jar安装到本地~/.m2/repository/对应路径下（如com/example/mylib/1.0.0/mylib-1.0.0-sources.jar） - 执行
mvn clean deploy：若使用私有 Maven 仓库（如 Nexus、Artifactory），该命令会把-sources.jar一并上传，其他团队成员才能拉取到 - 验证是否成功：直接去本地仓库对应目录查看是否存在
-sources.jar文件，这是最可靠的判断依据
在 IDEA 中触发源码自动关联
IDEA 不会默认下载 sources，需主动触发，且已有依赖不会自动补全。
立即学习“Java免费学习笔记（深入）”；
- 右键点击项目 → Maven → Download Sources and Documentation（注意：菜单灰掉说明项目未被正确识别为 Maven 项目，检查
pom.xml是否有误） - 或在终端运行：
mvn dependency:sources -DdownloadSources=true，加-Dmaven.repo.local=...可指定仓库路径，避免混淆 - 确认效果：展开 External Libraries → 找到对应依赖 → 展开后应出现 src 节点；点击类名跳转时不再显示
/* compiled code */ - 补充：若某依赖是 BOM 管理的（如
spring-boot-dependencies），其子依赖可能不被自动拉取源码，需单独指定：mvn dependency:sources -Dincludes=com.google.guava:guava
VS Code 或离线环境的手动补源方式
当网络受限、私服未发布源码，或只需临时调试单个 jar 时，手动 Attach 更直接。
- 打开 Project Settings → Libraries → 找到目标 jar → 点击右侧 + → Attach Sources
- 若手头有
-sources.jar：直接选中该文件，IDEA/VS Code 会自动解压并映射 - 若只有源码目录：选择含
src/main/java结构的根文件夹（例如mylib/src/main/java），不要选错成src上一级或lib目录 - VS Code 用户需先安装 Maven for Java 和 Language Support for Java 插件，再通过命令面板运行
Maven: Download project dependencies sources
