JADX 完整教程：从 APK 反编译到 Java 源码还原

做 Android 逆向或者开发调试时，手里只有一个 APK 却没有源码，很多人第一反应就是“反编译”。JADX 这个工具，在我用过的一堆方案里算是体验最省心的：下载、安装、把 APK 拖进去，Java 源码就出来了。这篇教程我打算把 JADX 的下载、安装和首次使用从头到尾捋一遍，从下载渠道到环境变量，再到常见报错，全部按实际操作来写。哪怕你之前没碰过逆向，照着这篇走完，也能把 JADX 跑起来。

先说明一下，教程里的“附安装包”不是说我在文末塞了一个网盘链接。JADX 更新速度不慢，网盘里的版本很快就会过时，还可能被第三方改动。我建议你直接去官方 GitHub Releases 页面下载最新版，我会把每个平台该选哪个文件、下载之后怎么校验、怎么安装都写清楚。老规矩，只反编译你自己有权限分析的 APK，这既是对原作者的尊重，也是这一行能持续下去的基础。

1. 下载前的工具认知：JADX 凭什么值得装

1.1 一个 APK 在 JADX 里能变成什么

JADX 全称是 Java Android Decompiler，名字很直白。它的核心功能就是把 Android 应用安装包里的 dex 字节码转换成我们可以读的 Java 源码。过去传统方案是先用 dex2jar 把 dex 转成 jar，再用 JD-GUI 打开 jar 看代码，中间一旦遇到多 dex 或者复杂的字符串加密，就容易断在某个环节。JADX 把这些步骤合并成了一个动作：直接把 .apk 拖进窗口，等待进度条走完，左侧是包名树，右侧就是还原出来的 Java 代码。

JADX 能看到的还不止代码。AndroidManifest.xml、资源索引值、布局 XML、图片资源、字符串资源，它都会帮你整理好。对于大多数做分析的人来说，这意味着一个工具就能覆盖“看入口、看权限、看逻辑、看资源”的完整链路，不用在多个软件之间来回切换。尤其是刚入行的朋友，第一次把 APK 拖进 JADX，看到完整源码的瞬间，基本都会觉得这个工具值得装。

1.2 和 dex2jar + JD-GUI 那套老组合比，优势在哪

如果只用一句话概括，我会说 JADX 把“看代码”这个核心体验做到了极致。JD-GUI 看反编译结果时，经常会出现变量名退化成 a、b、c 之类或者代码结构错乱的情况，JADX 在语法还原上更接近编译器源码。它对匿名内部类、lambda、switch 字符串哈希的处理都做了优化，分析业务逻辑的时候干扰少很多。

拿我自己的一个体验来说：以前用 dex2jar 处理好几个 dex 的 App 时，经常要手动 merge，类重复定义的问题能把人逼疯。JADX 会自动合并所有 dex，类名冲突的也会保留并标注。这一点在分析微信、淘宝这种大型应用时尤其重要。下表是我自己常用的几个工具横向对比，方便你选型：

平时我把 JADX 当主力阅读工具，遇到需要改资源再回编的情况才会搬出 apktool。如果某个 App 做了很强的代码混淆，JADX 依然能给你一个可读的框架，只是具体逻辑会像“被揉碎的纸片”，这时候就要配合 smali 和动态调试继续往下追了，这一点后面会单独讲。

2. 下载安装前的环境准备

2.1 到哪儿下载靠谱版本

JADX 的官方发布地址在 GitHub 上，项目名是 skylot/jadx。我不建议在搜索引擎首页随便点“高速下载”，原因很简单：这种会被 SEO 优化过的页面经常带捆绑软件，你还没装上 JADX，先被安装上一堆全家桶。正确做法是打开 GitHub Releases 页面，认准发布的 tag，一般形式是 v1.5.x。页面里会列出当前版本的发行包，常见的有：

jadx-x.x.x.zip # 通用压缩包，Windows / macOS / Linux 都能用 jadx-x.x.x.msi # Windows 安装程序 jadx-x.x.x.dmg # macOS 磁盘映像 jadx-x.x.x.tgz # Linux 压缩包

选好文件后，如果下载慢，可以找找有没有镜像源，但务必保证文件校验值和官方发布的一致。官方页面一般会提供 SHA256 散列值，下载完之后用 PowerShell 或终端算一遍，比对一致再解压。这一步看着麻烦，却能过滤掉绝大多数第三方改包。Windows 下校验 SHA256 的命令是：

Get-FileHash .\jadx-1.5.1.zip -Algorithm SHA256

macOS 和 Linux 用自带的shasum -a 256或sha256sum就能算。比对结果那串字符串和官方发布页是否一致，一致再继续，这是我多年下载工具养成的习惯。

2.2 Java 环境检查与安装

JADX 是用 Java 写的，运行它必须要有 Java 运行时环境，而且不是随便一个旧版本都行。当前主流 JADX 版本要求 Java 11 及以上，我本机用的是 OpenJDK 17，跑 1.5.x 没有任何问题。检查方法很简单，打开终端窗口，输入：

java -version

如果系统提示找不到 java，或者显示版本是 1.8，那就要先去装一个 JDK。发行版不限，Oracle JDK、Eclipse Temurin、Zulu、腾讯 Kona 都可以，选一个比较全的开源版本安装。安装完之后关键一步是配环境变量，Windows 用户在系统变量里新建JAVA_HOME，指向 JDK 安装目录，然后把%JAVA_HOME%\bin追加到Path。macOS 用户装完 .pkg 一般会自动配置好，Linux 用户根据自己的包管理器安装即可。

这里有一个经验：如果你电脑上已经装过 Android Studio，那么往往已经自带 JBR（JetBrains Runtime），JADX 大概率能直接覆盖以前的版本。但如果你同时装了多个 Java 版本，终端里的java -version显示的可能不是你想用的那个，后续启动 JADX 报版本不足时，优先检查这里。还有一个小技巧：很多系统自带 Java 配置管理命令，Windows 可以用where java，macOS/Linux 可以用which java来确认实际生效的是哪个路径。

2.3 把命令行工具加进 PATH（可选）

JADX 安装包里其实带了两套入口：图形界面jadx-gui和命令行jadx。日常拖 APK 看代码用 GUI 就够了，但如果你想写脚本批量反编译，或者通过命令行导出工程，就需要把bin目录加进 PATH。

Windows 下解压后的目录假定是D:\tools\jadx-1.5.1，那么在“系统属性 -> 环境变量”里找到Path，新增一行D:\tools\jadx-1.5.1\bin。macOS/Linux 下直接把解压目录里的bin做成软链接，或者把这一行写进.bashrc/.zshrc：

export PATH="$HOME/tools/jadx-1.5.1/bin:$PATH"

配好之后重新打开终端，输入jadx --version，能看到版本号就说明环境没有问题了。这一步不是必须的，但配好之后会让后面的命令行操作顺滑不少。尤其是后面讲批量反编译的时候，不用每次都敲一长串绝对路径，体验完全不同。

3. JADX 安装全过程图文拆解

3.1 Windows 用户：zip 包免安装玩法

我第一次用 JADX 的时候，选的就是 zip 包，原因是不需要注册表和安装记录，解压就能用。具体流程如下：下载jadx-x.x.x.zip，建议放到一个不含中文和空格的路径下，比如D:\tools\jadx-1.5.1，因为后面的脚本对路径里的特殊字符可能会出问题。右键压缩包选择“解压到当前文件夹”，完成后你会看到类似这样的目录结构：

D:\tools\jadx-1.5.1 │ ├─ bin │ ├─ jadx.bat │ ├─ jadx-gui.bat │ └─ jadx-gui │ └─ lib ├─ jadx-1.5.1.jar └─ ...

打开bin目录，双击jadx-gui.bat，稍等一两秒会弹出一个深色主题的主窗口。如果双击后没有任何反应，或者屏幕闪了一下就没了，大概率是 Java 环境的问题。你先打开一个 cmd 窗口，手动切到bin目录执行：

jadx-gui.bat

这样屏幕上会留下具体的报错信息，排查起来会清楚很多。等窗口启动成功后，顶部菜单是File、View、Navigation、Tools这些标准菜单，界面布局非常接近常见的 IDE，几乎不需要学习成本。首次使用我建议先随便找一个 APK 打开，滚动一下源码面板，感受一下字体和配色，不喜欢就去View -> Theme里换主题。

3.2 Windows 用户：MSI 安装包玩法

如果你习惯像装普通软件一样点“下一步”，那选 MSI 安装包。双击运行安装向导，一路 Next，到选择安装目录那一步，仍然建议改成纯英文路径。安装完成后开始菜单里会多出来一个 JADX 文件夹，里面有jadx和jadx-gui两个快捷方式。MSI 版的好处是它会自动把相关命令注册好，你不需要手动配 PATH；缺点是卸载和更新的时候，某些杀毒软件可能会把它当成可疑程序。遇到这种情况不用慌，把jadx-gui.exe或者安装目录加入杀毒软件的信任列表就行。

另外，MSI 安装的版本如果以后要卸载，记得别直接删安装目录，不然注册表里留一堆垃圾。去“设置 -> 应用 -> 已安装的应用”，找到 JADX 再卸载，顺便能把 JADX 的缓存文件清理干净。这样下次装新版时不会出现环境冲突。

3.3 macOS 用户：DMG 拖拽安装

macOS 下打开下载的.dmg文件，系统会挂载出一个磁盘映像窗口，里面一般有一个 JADX 应用图标和一个 Applications 文件夹的替身。你只需要把 JADX 图标拖到 Applications 文件夹里就完成了安装。首次启动时如果提示“无法打开，因为 Apple 无法检查其是否包含恶意软件”，去“系统偏好设置 -> 安全性与隐私 -> 通用”页面，点击“仍要打开”即可。如果连这个按钮都没有，可以在终端里执行：

xattr -dr com.apple.quarantine /Applications/jadx-gui.app

之后再启动就不会被拦了。需要注意的是 macOS 版的 GUI 入口其实是jadx-gui这个可执行脚本，如果你想把命令行工具软链到/usr/local/bin，可以直接链过去。不少 macOS 用户还习惯用 Homebrew 安装 JADX，命令是brew install jadx，这种方式能自动处理 Java 依赖，但版本更新可能略晚于官方 GitHub Release，怎么方便怎么来。

3.4 Linux 用户：tgz 包快速部署

Linux 用户下载.tgz压缩包或.zip都行，解压后进入目录，给 bin 下的脚本加上执行权限：

chmod +x bin/jadx bin/jadx-gui ./bin/jadx-gui

如果你是在无桌面环境的服务器上使用，那就用命令行版./bin/jadx app.apk，反编译结果会输出到指定目录。我经常在远程机器上跑批量反编译，再用 scp 把结果拉到本地用 GUI 翻，这样能省下不少本地内存。Linux 用户还需要注意一点：如果用的是精简版系统，可能缺少libgtk-3之类的图形库，GUI 启动会报错。建议在带桌面的发行版上直接运行，服务器环境老老实实用命令行版就好。

4. 第一次实战：从 APK 到 Java 源码

4.1 准备一个测试 APK

学习阶段不建议直接拿一个商业 App 练手。你可以去 GitHub 上找一个开源项目的 debug APK，或者用 Android Studio 自己打一个包。这样做有好处：第一，代码本来就能看到，方便你对照 JADX 反编译的结果准不准；第二，不会触碰使用条款，避免不必要的麻烦。如果确实要分析某个 App，请确保你有足够的授权，或者是在合规的测试环境里进行。

自己打测试包的时候，我建议打开 Android Studio 的开发者选项里的“不压缩库文件”功能，默认反编译资源时就不会被压缩干扰。如果你手头连 Android Studio 都没有，也可以去一些开源社区找现成的 sample APK。总之先准备一个小体积、结构简单的包，第一次运行会顺很多。

4.2 jadx-gui 的界面操作

打开 GUI 之后，File -> Open file...，选择你要分析的 APK。文件会开始加载，左下角的进度条会显示解析到哪个阶段。遇到大型 APK 时，这一步可能持续几十秒，耐心等待就好，不要反复点击菜单。加载完成后，左侧是一个树形结构，按照包名层级展开；右侧显示选中类对应的源码。很多新手第一次看到这一屏会很兴奋，但要注意：这个窗口不是简简单单的“源码阅读器”，它还有很多实用功能藏得很深。

常用的几个操作：按Ctrl+Shift+F全局搜索字符串或类名，这对定位某个页面特别有用；在左侧树里右键类名，选择Find Usage，可以查看这个方法被谁调用；顶部Tools菜单里还有反混淆重命名、保存为 Gradle project 等功能。我个人最常用的是Navigation -> Search class by name，输入 Activity 名称秒跳到目标类。如果你要找某个应用的主入口，可以看AndroidManifest.xml里带有MAIN和LAUNCHERaction 的 Activity，再顺着它往下翻 onCreate，整个启动流程就很清晰了。

4.3 项目导出与命令行反编译

GUI 适合人工分析，批量场景还是要靠命令行。先把完整命令贴出来：

jadx -d output_dir your_app.apk

-d指定输出目录，运行结束后输出目录里会有sources文件夹和resources文件夹，前者是还原出来的 Java 源码，后者是资源文件。如果你想在 Android Studio 里导入继续改源码，JADX 也支持导出 Gradle 工程，GUI 里是File -> Save as Gradle project...，命令行参数是--export-gradle。用这种方式导出的工程结构和正经 Android 项目已经比较接近，但不要指望能一行不改直接编译，官方文档自己都说了：“反编译后的代码只能作为参考”。

这里还有一个非常实用的参数--show-bad-code，遇到某些 JADX 无法完整还原的代码块时，它会把这部分用近似代码展示出来，而不是直接留空。分析疑难样本时，我基本都会加上。命令行版的完整调用我常用的是：

jadx -d out --show-bad-code --no-res app.apk

--no-res表示只反编译代码，不导出资源文件，速度会快很多。如果你只关心某个关键方法，可以用--single-class来导出指定类，减少无关干扰。

5. 安装和使用中的高频问题与排查实录

5.1 双击 bat 闪退的排查套路

Windows 上最容易遇到的问题就是双击jadx-gui.bat后，黑色窗口一闪而过，GUI 没起来。绝大多数原因是 Java 没装好，或者 Java 版本低于要求。首先要做的不是重装，而是用当前用户的命令行窗口手动执行这个 bat。命令行会显示具体的错误，如果提示'java' 不是内部或外部命令，说明 Java 没配置到 PATH；如果提示UnsupportedClassVersionError，说明版本不够，去装 Java 11 以上的 JDK。还有一个常见坑：用户装的是 32 位 JDK，而系统是 64 位，也可能导致启动异常，建议统一用 64 位版本。

另外，如果你把解压路径放在C:\Program Files这种带空格和权限控制的目录里，也有概率遇到脚本找不到类路径的问题。把整个 JADX 目录移到D:\tools这种简单路径，能省掉很多烦恼。还有一个容易被忽略的问题：杀毒软件实时防护。有的安全软件会把jadx-gui.bat或java.exe的运行拦截掉，导致界面闪退。去安全中心看拦截记录，把 JADX 目录加白名单，问题立刻消失。

5.2 内存不足或卡在加载界面

JADX 默认的 JVM 堆内存不是很大，遇到几十 MB 甚至上百 MB 的 APK，会卡在解析 dex 的过程里，甚至直接报OutOfMemoryError。解决办法是修改脚本里的 JVM 参数。Windows 的jadx-gui.bat里会读取一个环境变量JADX_OPTS，你可以在系统环境变量里新增：

JADX_OPTS=-Xmx2g

macOS/Linux 下同样把JADX_OPTS导出后再启动。-Xmx2g表示最大堆内存 2GB，如果你内存富余，可以设到 4g。调大之后，大型应用反编译的成功率会明显提高。另外，反编译是 CPU 密集型任务，多核机器可以加-j 0让 JADX 自动使用所有可用核心，速度提升非常明显。如果你是在命令行版里跑，直接写：

jadx -j 0 -Xmx2g -d out app.apk

注意，JVM 参数要放在java命令后面而不是jadx后面，所以通过环境变量来传递是最稳妥的方式。

5.3 中文注释乱码怎么处理

有时反编译出来的源码里，中文字符串全都变成了方块或问号。这一般不是 JADX 的问题，而是文件编码没有设置为 UTF-8。GUI 启动时可以在jadx-gui.bat前加一行set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8，或者在你的JADX_OPTS里补上-Dfile.encoding=UTF-8。改完重启工具，字符串基本就能正常显示了。某些资源文件本身就用了 GBK 编码，这时要看原始 APK 的情况，JADX 会尽可能地按声明编码去解。

这个问题在 Windows 中文系统上尤其常见，因为系统默认代码页是 GBK，Java 读取文件时如果没有显式指定 UTF-8，就会按系统默认编码去解析。建议在环境变量里把JAVA_TOOL_OPTIONS和JADX_OPTS都加上 UTF-8 配置。修改完记得重启终端和 JADX，不然不生效。

5.4 反编译结果与源码不一致，正常吗

很多新人看到反编译代码和自己写的源码对不上，会以为工具坏了。其实 JADX 本质上是在做“翻译”，它没有原始符号表，只能根据字节码逆推。编译器做过内联、常量折叠、switch 优化之后，反编译代码和原来写的多多少少会不一样。遇到明显不合理的逻辑，可以先看看是不是混淆过的原因。混淆会把类名、方法名改成 a、b、c，甚至加入无用代码，JADX 再厉害也变不回人类命名的样子。这时候有两条路：一是用 JADX 自带的反混淆功能，它会给变量重新起有意义的名称；二是对着 smali 逐行看，虽然累，但能看到最底层的东西。

JADX 的反混淆功能在Tools -> Deobfuscation菜单下，它会尝试根据上下文推断变量含义，但不能保证 100% 还原。对于严重混淆的代码，我更推荐 JADX 配合--deobf参数，在命令行里导出时自动做反混淆，效果比 GUI 里的默认选项好一截。还有一个规律：如果反编译后的代码里频繁出现goto或者异常 try/catch 嵌套，往往说明源码用了 ASM 字节码插桩或者双护城河加固，这时候不要死磕 JADX，换个动态分析的思路可能更高效。

6. 我的实操心得与后续扩展

6.1 让 JADX 更好用的几个小配置

第一次打开 JADX，你会觉得深色主题很酷，但长时间看字会觉得累。我习惯在View -> Theme里切到浅色主题，再把字体调成等宽字体，比如 JetBrains Mono 或 Consolas。遇到某个类源码行数特别多时，可以用View -> Show Bytecode在源码和字节码之间快速切换，定位到关键逻辑后再切回 Java 视图，这种阅读效率比单纯抱着反编译源码啃高很多。还有一个快捷键值得记住：在左侧树里按类名首字母，能快速跳到对应的类；在源码里按Ctrl+B，可以直接跳转到方法定义。

GUI 默认会在启动时加载上一次打开过的项目，如果不希望泄露工作痕迹，可以在Setting里关掉“Restore previous session”。我还会把Code area -> Word wrap打开，长行逻辑读起来不用横向拖滚动条。这些配置看起来都是小事，但实际分析一整天代码后，体验差别非常大。

6.2 组合拳：JADX + apktool + 动态调试

JADX 不是万能的。碰到需要修改资源再回编译的场景，我会用 apktool 解包和重打包；碰到关键逻辑走不通时，再用动态调试工具在系统层去验证。一个典型流程是这样：先用 JADX 打开 APK，定位到目标方法，确认它最终调用了哪些 native 函数；接着用 apktool 解包，看看 so 文件在哪里；最后用调试器 hook 一下参数，看真正传给 native 层的数据是不是 JADX 里看到的那样。这套组合拳能覆盖大多数逆向分析的常规需求，而 JADX 在其中承担的是“地图”的角色，先有地图再去探索，比直接深入底层高效得多。

简单说就是 JADX 负责静态代码阅读，apktool 负责资源修改和重打包，动态调试负责验证运行时行为。三者各司其职，缺一不可。如果你是刚开始接触，可以把一个简单的开源 App 从 JADX 到动态调试完整走一遍，比看一百篇教程都有用。

6.3 学习方向与合规提醒

如果你是因为兴趣开始接触 JADX，我建议把 Android 开发四大组件、dex 文件格式、smali 语法这三块补一补。逆向分析不是只会按按钮，理解了底层数据结构和系统启动流程，你看到的反编译代码才会从“天书”变成“有逻辑的文档”。同时也提醒一句：反编译别人的应用之前，一定要确认授权边界。你可以用它来分析自己开发的 App 的加固是否到位，也可以用它做安全研究，但不要拿 JADX 去窃取别人的核心代码或绕过付费机制。工具本身没有立场，使用方式决定了它的价值。

最后分享一个我个人的操作习惯：每次更新 JADX 版本前，我会先把旧版本目录整个删掉，再用新版本重新跑一遍平时常用的那批 APK。JADX 的更新经常带来反编译逻辑的改进，有些老版本里崩溃的样本，新版可能一次就解开了。留一台干净的环境，能帮你更快发现新版本的脾气。