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 就纯属形式。遇到这种，得先确认授权是否允许调试，再决定要不要联系供应商要源码包。
