杰瑞科技汇

Java Eclipse源代码如何高效阅读与调试?

  1. 查看你项目中自己的 Java 源代码:这是最基本的功能。
  2. 查看 Java 标准库(如 java.lang, java.util 等)或第三方库的源代码:这是开发中非常关键的一步,有助于理解底层实现和调试。

下面我将分步详细解释这两种情况。

Java Eclipse源代码如何高效阅读与调试?-图1
(图片来源网络,侵删)

查看项目自己的 Java 源代码

这非常简单,Eclipse 的基本工作区视图就是为了这个设计的。

操作步骤:

  1. 打开 Eclipse 并切换到 Java 透视图

    如果窗口顶部没有显示 "Java" 相关的图标(如 "Package Explorer", "Outline"),请点击窗口右上角的 "Open Perspective" 按钮(一个像小房子的图标),然后选择 "Java"。

  2. 使用 "Package Explorer" (包资源管理器)

    Java Eclipse源代码如何高效阅读与调试?-图2
    (图片来源网络,侵删)
    • 这是最常用的视图,在左侧的 "Package Explorer" 中,你会看到一个代表你项目的文件夹图标。
    • 展开你的项目,你会看到一个 src 文件夹(Source 的缩写),你的所有 Java 源代码文件(.java 文件)都在这里。
    • 展开 src 文件夹,然后继续展开包(package)结构,直到找到你想要查看的 .java 文件。
    • 双击该文件,它就会在 Eclipse 的编辑器中打开,你就可以看到并编辑源代码了。
  3. 使用 "Project Explorer" (项目资源管理器)

    • 这个视图和 "Package Explorer" 类似,但它显示的是更底层的文件系统结构,包括 .project.classpath 等项目配置文件。
    • 操作方式相同:展开项目 -> 展开 src -> 找到并打开 .java 文件。

对于自己的代码,核心就是通过 Package ExplorerProject Explorer 导航到 src 目录下的文件并双击打开。


查看 JDK 或第三方库的源代码

当你调用一个 JDK 自带的方法(如 System.out.println())或者一个第三方库的方法时,默认情况下 Eclipse 可能只显示编译后的字节码(.class 文件),而不是可读的源代码(.java 文件),这时你需要配置 Eclipse 去找到这些源代码。

步骤 1:确保你的项目已附加 Javadoc 和源代码

在创建项目或导入项目时,Eclipse 通常会自动尝试下载或关联 JDK 的 Javadoc 和源代码,你可以检查一下。

Java Eclipse源代码如何高效阅读与调试?-图3
(图片来源网络,侵删)
  1. 在 "Package Explorer" 中,右键点击你的项目 -> Properties (属性)
  2. 在弹出的窗口中,导航到 Java Build Path -> Libraries
  3. 在列表中,找到你正在使用的 JRE 或 JDK(JavaSE-11Apache Tomcat v9.0)。
  4. 点击它,然后点击右侧的 "Source Attachment" (源代码附件)"Javadoc location" (Javadoc 位置)
  5. 对于 Source Attachment
    • 如果路径已经指向了你的 JDK 安装目录下的 src.zip 文件(C:\Program Files\Java\jdk-11.0.12\lib\src.zip),那么恭喜你,已经配置好了。
    • 如果没有,点击 "Edit...",然后浏览并选择你 JDK 目录下的 src.zip 文件。src.zip 是 JDK 源代码的标准压缩包。
  6. 对于 Javadoc location
    • 类似地,你可以提供一个 URL 指向 Oracle 官网的 Javadoc 文档,这样在按住 Ctrl 鼠标悬停在方法上时,会弹出 Javadoc 说明。

步骤 2:手动附加第三方库的源代码

当你引入一个外部的 JAR 包(例如通过 Maven/Gradle 或手动添加)时,Eclipse 通常找不到它的源代码,这时你需要手动下载并附加它。

  1. 找到源代码 JAR 文件

    • 对于 Maven 项目,最简单的方法是:在 "Package Explorer" 中,右键点击 pom.xml -> Maven -> Update Project...,Eclipse 会自动尝试下载依赖的源代码 JAR 文件(通常命名为 artifact-name-sources.jar)。
    • 如果自动下载失败,你需要手动去 Maven 中央仓库 或项目官网下载对应的 *-sources.jar 文件。
  2. 附加源代码到 JAR 包

    • 在 "Package Explorer" 中,右键点击你的项目 -> Properties
    • 导航到 Java Build Path -> Libraries
    • 在列表中,找到你想要附加源代码的那个外部 JAR 包(commons-lang3-3.12.0.jar),选中它。
    • 点击右侧的 "Source Attachment..." (源代码附件) 按钮。
    • 在弹出的窗口中,点击 "External Location" (外部位置) -> "External File..." (外部文件)
    • 浏览并选择你刚刚下载的 *-sources.jar 文件。
    • 点击 OK 保存所有设置。

步骤 3:如何查看源代码

配置完成后,查看源代码非常方便:

  • 使用 "Open Declaration" (打开声明)

    • 在你的代码中,将光标放在任何一个你想要查看其源代码的方法或类上(String 类的 equals() 方法)。
    • 按下快捷键 F3,或者右键点击 -> Open Declaration
    • Eclipse 会自动跳转到该方法的源代码所在的文件,并高亮显示那行代码。
  • 使用 "Source Lookup" (源代码查找)

    • 同样,将光标放在方法或类上。
    • 按下快捷键 Ctrl + Shift + T (打开类型) 或 Ctrl + Shift + H (打开层次结构),然后输入类名,在搜索结果中可以看到源代码是否可用。
  • 悬停查看 Javadoc

    • 将鼠标光标悬停在任何方法或类上,Eclipse 会显示一个信息框。
    • 如果配置了 Javadoc,它会显示文档;如果同时配置了源代码,信息框里还会有一个 "Attach Source..." (附加源代码) 的链接,点击它可以直接查看源码。

常见问题与解决

问题:按下 F3 后,提示 "The source attachment does not contain the source for the file [xxx.class]"。 原因:该库的源代码没有正确附加。 解决:按照 “步骤 2” 重新检查并附加正确的 *-sources.jar 文件。

问题:在 Maven 项目中,依赖的源代码一直下载不下来。 原因:可能是网络问题,或者 Maven 的 pom.xml 中没有正确配置 <scope> 或依赖信息。 解决

  1. 检查网络连接。
  2. 手动去 Maven Repository 搜索你的依赖,查看正确的 pom.xml 依赖配置。
  3. 在 "Package Explorer" 中右键点击项目 -> Maven -> Update Project... 强制刷新。

问题:我想查看整个 JDK 的源代码,而不是 src.zip 解决

  1. 去 Oracle 官网下载完整的 JDK 源代码压缩包(openjdk-11-src.zip)。
  2. Java Build Path -> Libraries -> Source Attachment 中,不要选择 src.zip,而是解压你下载的完整源码包,然后选择那个解压后的根目录,这样你就可以浏览所有 JDK 的源码了,而不仅仅是核心 API。

希望这份详细的指南能帮助你顺利地在 Eclipse 中查看任何 Java 源代码!

分享:
扫描分享到社交APP
上一篇
下一篇