intellij idea 中点击 jar 无法查看源码,主因是未正确关联源码路径。需检查是否缺失 -sources.jar、手动 attach sources 或通过 maven 执行 dependency:sources 下载源码,避免硬编码绝对路径。

IntelliJ IDEA 里点进 jar 却看不到源码?先确认是否真没关联上
不是所有 .jar 都自带源码,IDEA 默认只加载 classes。点开类时显示 “Sources not found” 或一片灰色反编译代码,大概率是 Source 路径压根没配,或者配错了位置。
常见错误现象:Ctrl+Click 进去看到的是 /* compiled code */;External Libraries 下对应 jar 展开后没有 src 子节点;File → Project Structure → Libraries 里该 jar 的 Sourcepath 显示为空或 <no source></no>。
- 优先检查 Maven/Gradle 项目:如果用的是
mvn dependency:sources或 IDE 自动下载源码功能,得确认本地仓库里对应 artifact 确实有-sources.jar(比如guava-32.1.3-jre-sources.jar) - 手动添加时路径必须指向
.jar或解压后的src目录,不能选错成.class文件或lib根目录 - 如果项目用了
spring-boot-dependencies这类 BOM,某些依赖的源码可能不会被自动拉取,需要单独mvn dependency:sources -DincludeGroupIds=com.example
手动 Attach Source:适用于单个 jar 或离线环境
适合没有网络、Maven 源未发布、或只想给某个特定 jar 补源码的场景。本质是告诉 IDEA:“这个 jar 的源码长这样”。
操作路径:Project Structure → Libraries → 找到目标 jar → 右侧点 + → Attach Sources。
- 如果手头有
-sources.jar:直接选它(IDEA 会自动识别并展开) - 如果只有解压后的源码目录:选中那个含
java/子目录的文件夹(比如okhttp/src/main/java),不要选错成src/上层 - 不建议选
.zip或.rar:IDEA 对非标准压缩包支持不稳定,容易报Cannot attach source archive - 附带 Javadoc 的话,同位置可再点
Attach JavaDoc,但和源码无关,不影响跳转
Maven 项目自动下载源码:别只靠 Auto-import
IDEA 的 Auto-import 默认不下载 sources,即使勾了 “Download library sources” 也只对新导入生效。已有依赖不会自动补。
真正起作用的是 Maven 命令或 IDE 内置触发:
- 命令行执行:
mvn dependency:sources -DdownloadSources=true(推荐加-Dmaven.repo.local=...明确仓库路径) - IDEA 内右键项目 →
Maven → Download Sources and Documentation(注意:这个菜单项有时灰掉,需先确保项目已识别为 Maven 项目且pom.xml无语法错误) - 如果某依赖在
repository中只有 binary,没有-sources.jar(比如部分私有组件),命令会静默失败,不会报错,得去本地.m2/repository里手动确认文件是否存在
Eclipse 用户切 IDEA 后常踩的坑:Source path 不继承、不共享
Eclipse 的 Attach Source 是 per-project 的,而 IDEA 的 Library 配置是全局或 module 级的。从 Eclipse 迁移过来的人容易以为“之前配过一次就永远有效”,其实不是。
- 新建 module 时,旧的 Library 关联不会自动复制过去,得重新 Attach
- 团队协作时,
.iml和.idea/libraries/下的 XML 不建议提交,否则容易因路径硬编码导致别人打开就红(比如C:\Users\Alice\.m2\...) - 更稳妥的做法是:统一用 Maven 管理依赖,靠
dependency:sources下载,而非手动绑定绝对路径 - 如果必须手动配,用相对路径(如
$PROJECT_DIR$/libs/commons-lang3-sources.jar)并把源码包放进项目目录下,避免路径漂移
最麻烦的其实是那种既没发布 -sources.jar、又没开源、还加密了 class 的商业 jar——这时候连反编译都受限,Attach Source 就纯属形式。遇到这种,得先确认授权是否允许调试,再决定要不要联系供应商要源码包。










