JD-GUI Java反编译工具使用教程

JD-GUI 是一个独立的图形化工具，用于显示 CLASS 文件的 Java 源代码。它可以帮助开发者快速浏览和分析已编译的 Java 类文件。

项目结构与介绍

JD-GUI 项目采用模块化设计，主要包含以下核心模块：

• api模块：提供核心 API 接口和 SPI 扩展机制
• app模块：主应用程序模块，包含 GUI 界面和控制器
• services模块：提供各种服务实现，包括文件加载、索引、反编译等功能

项目使用 Gradle 作为构建工具，支持多平台打包和部署。

安装与构建

克隆项目

git clone https://gitcode.com/gh_mirrors/jd/jd-gui
cd jd-gui

构建项目

./gradlew build

构建完成后将生成以下文件：

• build/libs/jd-gui-x.y.z.jar：完整版 JAR 文件
• build/libs/jd-gui-x.y.z-min.jar：精简版 JAR 文件
• build/distributions/jd-gui-windows-x.y.z.zip：Windows 平台发行包
• build/distributions/jd-gui-osx-x.y.z.tar：macOS 平台发行包

启动方式

JD-GUI 支持多种启动方式：

1. 双击启动：直接双击 jd-gui-x.y.z.jar 文件
2. 命令行启动：

   java -jar jd-gui-x.y.z.jar
   

   或者

   java -classpath jd-gui-x.y.z.jar org.jd.gui.App
   

基本使用方法

打开文件

• 通过菜单 "File > Open File..." 打开单个文件
• 通过菜单 "File > Recent Files" 打开最近访问的文件
• 支持拖放操作：直接从文件管理器拖拽文件到 JD-GUI 窗口

界面功能

JD-GUI 主界面分为三个主要区域：

• 左侧：文件树状结构浏览器
• 右上：反编译的源代码显示区域
• 右下：方法和字段的详细信息面板

代码导航

• 使用 Ctrl+F 进行代码搜索
• 点击方法名可以跳转到对应的定义
• 使用书签功能标记重要代码位置

配置文件说明

JD-GUI 使用配置文件存储用户偏好设置，配置文件通常位于：

• Windows: %USERPROFILE%\.jd-gui\jd-gui.cfg
• macOS: $HOME/.jd-gui/jd-gui.cfg
• Linux: $HOME/.jd-gui/jd-gui.cfg

配置文件采用 JSON 格式，包含以下主要配置项：

{
  "window_position": {
    "x": 100,
    "y": 100
  },
  "window_size": {
    "width": 800,
    "height": 600
  },
  "recent_files": [
    "path/to/file1.class",
    "path/to/file2.class"
  ],
  "decompiler_preferences": {
    "show_line_numbers": true,
    "show_metadata": false
  }
}

扩展开发

JD-GUI 支持通过 SPI 机制进行功能扩展：

创建扩展项目

./gradlew idea  # 生成 IntelliJ IDEA 项目
./gradlew eclipse  # 生成 Eclipse 项目

加载扩展

java -classpath jd-gui-x.y.z.jar;myextension1.jar;myextension2.jar org.jd.gui.App

常见问题处理

内存配置

如果遇到内存不足问题，可以调整 JVM 参数：

java -Xmx2g -jar jd-gui-x.y.z.jar

字体显示问题

如果源代码显示乱码，可以在配置文件中调整字体设置。

卸载方法

• Java版本：删除 jd-gui-x.y.z.jar 和 jd-gui.cfg 文件
• Windows版本：删除 jd-gui.exe 和 jd-gui.cfg 文件
• macOS版本：将 JD-GUI 应用程序拖到废纸篓

技术特点

JD-GUI 基于 JD-Core 反编译引擎，具有以下特点：

• 支持 Java 5 到 Java 8 的字节码反编译
• 实时反编译，无需预编译
• 完整的类型层次结构显示
• 支持多文件格式：JAR、WAR、EAR、ZIP 等
• 跨平台支持：Windows、macOS、Linux

通过 JD-GUI，开发者可以方便地查看和分析第三方库的源代码，是 Java 开发者的重要调试和分析工具。