Eclipse中JUnit5源码未找到：如何添加JUnit5源码？

我之前也碰到过这个「Source not found」的提示，尤其是用Eclipse内置JUnit库的时候，确实会出现Source attachment无法编辑的情况。下面分步骤给你讲清楚怎么获取源码并正确附加：

一、获取JUnit5源码包的两种方式 #

方式1：通过构建工具自动获取（推荐） #

如果你的项目是用Maven或Gradle管理的，这是最省心的方法：

• 对于Maven项目：右键项目 → 选择「Maven」→ 点击「Download Sources」，Eclipse会自动从仓库拉取对应版本的JUnit5源码包并自动关联，不用手动下载。
• 对于Gradle项目：右键项目 → 选择「Gradle」→ 点击「Refresh Gradle Project」，然后在Gradle面板里找到对应的JUnit5依赖，右键选择「Download Sources」即可。

方式2：手动下载源码包 #

如果是手动添加的JUnit5依赖，或者构建工具下载失败，你可以找到对应版本的源码包：

1. 先确认你当前使用的JUnit5组件版本（比如junit-jupiter-api-5.9.2.jar）
2. 找到对应版本的sources.jar（比如junit-jupiter-api-5.9.2-sources.jar），注意版本号必须完全一致，否则源码和类文件会不匹配。

二、在Eclipse中附加源码的步骤 #

针对Maven/Gradle项目 #

只要执行了上面的「Download Sources」操作，Eclipse会自动完成源码关联，之后再点击JUnit5的类就能直接查看源码了。如果还是没生效，右键项目 → 「Maven」→ 「Update Project」，勾选「Force Update of Snapshots/Releases」后重试。

针对手动添加依赖的项目（解决Source attachment无法编辑的问题） #

如果你是用Eclipse内置的JUnit5库导致Source attachment无法编辑，建议先替换成手动导入的jar包：

1. 打开「Java Build Path」：右键项目 → 「Build Path」→ 「Configure Build Path」
2. 切换到「Libraries」标签页，找到内置的「JUnit5」库，点击「Remove」移除它
3. 点击「Add External Archives」，导入你下载的JUnit5核心jar包（比如junit-jupiter-api.jar、junit-jupiter-engine.jar等）
4. 选中刚导入的jar包，展开它，你会看到「Source attachment」选项，现在可以点击「Edit」按钮了
5. 在弹出的窗口中，选择你下载的对应版本的sources.jar或src.zip文件，点击「OK」完成关联

注意事项 #

• 一定要保证源码包的版本和你使用的JUnit5 jar包版本完全一致，不然会出现源码和类文件不匹配的情况
• 如果手动下载源码包，记得把所有用到的JUnit5组件的源码包都下载并关联（比如junit-jupiter-api、junit-jupiter-params等）

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