DebugTools

简体中文

English

简体中文

English

主题

安装说明 ​

DebugTools 插件最低支持 IntelliJ IDEA 2023.3（build 233）。使用 MCP 工具还需要支持并启用 MCP Server 的 IDEA，详见 IDEA MCP 使用说明。

1. 安装插件 ​

1.1 Marketplace 商店（推荐） ​

  1. 打开 IDE Settings 并选择 Plugins
  2. 在 Marketplace 搜索 DebugTools 并点击 install
  3. 重启应用

marketplace

1.2 自行安装 ​

text
https://plugins.jetbrains.com/plugin/24463-debugtools
text
https://download.debug-tools.cc/DebugToolsIdeaPlugin.zip
sh
git clone https://github.com/future0923/debug-tools.git
cd debug-tools
# maven打包需要使用 `java17+` 版本构建
mvn clean install -T 2C -Dmaven.test.skip=true
# Agent 产物位于 debug-tools/dist
cd ..
git clone https://github.com/future0923/debug-tools-idea.git
cd debug-tools-idea
# 先完成上面的 Maven install，插件需要同版本 common 依赖。
# 当前 ideVersion=2026.1 对应 Java/Kotlin 21 toolchain，请准备 JDK 21。
./gradlew clean build -Pkotlin.daemon.jvmargs=-Xmx2g
# 插件 ZIP 位于 build/distributions，并由 build 复制到 dist。
# 文件名为 DebugTools-<pluginVersion>.zip
text
https://github.com/future0923/debug-tools/releases
text
https://gitee.com/future94/debug-tools/releases

安装或更新插件后重启 IDEA。远程或通过 -javaagent 预加载 Agent 的应用，需要同步替换目标机器上的 debug-tools-agent.jar 并重启 JVM，再建立连接。插件与 Agent 应保持配套，避免目标 JVM 缺少所需的运行时能力。

2. 安装JDK ​

只有使用热部署、热重载功能时才需要特定的JDK支持。

为了简化热部署安装步骤，linux支持一键安装，使用如下命令

shell
wget https://download.debug-tools.cc/install/linux-install.tar.gz -O linux-install.tar.gz && tar zxf linux-install.tar.gz && cd linux-install && ./install.sh

安装位置

  • jdk: /usr/local/java
  • debug-tools: /usr/local/debug-tools

2.1 JDK 8 ​

2.1.1 直接使用打包好的JDK包 （推荐） ​

通过github下载

https://github.com/future0923/debug-tools/releases/tag/dcevm-jdk-1.8.0_181

DebugTools官网下载

注意

  • 目前Mac OS并没有纯正的M芯片的DCEVM的jdk，上面提供的jdk是通过adopt jdk改造而来，本质还是x86架构的jdk。
  • 如果项目允许，非常推荐使用 JetBrainsRuntime 11+

2.1.2 自行安装 ​

Windows/Mac OS (intel)

下载对应版本的 .jar 文件。目前只支持下面版本的JDK，请选择对应版本的。

java versiondownload by debug toolsdownload by github
1.8.0_181DCEVM-8u181-installer.jarDCEVM-8u181-installer.jar
1.8.0_172DCEVM-8u172-installer.jarDCEVM-8u172-installer.jar
1.8.0_152DCEVM-8u152-installer.jarDCEVM-8u152-installer.jar
1.8.0_144DCEVM-8u144-installer.jarDCEVM-8u144-installer.jar
1.8.0_112DCEVM-8u112-installer.jarDCEVM-8u112-installer.jar
1.8.0_92DCEVM-8u92-installer.jarDCEVM-8u92-installer.jar
1.8.0_74DCEVM-8u74-installer.jarDCEVM-8u74-installer.jar
1.8.0_66DCEVM-8u66-installer.jarDCEVM-8u66-installer.jar
1.8.0_51DCEVM-8u51-installer.jarDCEVM-8u51-installer.jar
1.8.0_45DCEVM-8u45-installer.jarDCEVM-8u45-installer.jar

运行对应的 java -jar DCEVM-8uXX-installer.jar 文件，找到对应的版本，点击 Install DCEVM as altjvm 按钮即可。

dcevm-installer.png

Linux

如输入 java -XXaltjvm=dcevm -version 输入如下提示

text
Error: missing `dcevm' JVM at `/home/java/jdk1.8.0_291/jre/lib/amd64/dcevm/libjvm.so'.
Please install or use the JRE or JDK that contains these missing components.

下载对应版本的文件并改名为 libjvm.so 到上面提取的目录下即可。

java versiondownload by debug toolsdownload by github
>= 1.8.0_181libjvm181.solibjvm181.so
1.8.0_172libjvm172.solibjvm172.so
1.8.0_152libjvm152.solibjvm152.so
1.8.0_144libjvm144.solibjvm144.so
1.8.0_112libjvm112.solibjvm112.so
1.8.0_92libjvm92.solibjvm92.so
1.8.0_74libjvm74.solibjvm74.so
<= 1.8.0_66libjvm66.solibjvm66.so

2.2 JDK 11 ​

JetBrainsRuntime

使用 JetBrainsRuntime JDK 可以支持热部署/热重载。

请下载带有 JBR with JCEF (DCEVM) 或者 JBR with JCEF (fastdebug)。

建议使用最新版 11_0_15-b2043.56

2.3 JDK 17/21/25 ​

使用 JetBrainsRuntime JDK 可以支持热部署/热重载。

请下载带有 JBRSDK with JCEF 版本。

Java 17 建议使用最新版 17.0.14b1367.22

Java 21 建议使用 最新版 即可

Java 25 建议使用 最新版，如25b176.4。

还可以在 Project Structure 中下载jdk,选择JetBrains Runtime (JCEF)
jdk_download_idea

INFO

苹果系统如果下载JDK后提示已损坏或无法验证开发者等原因不能启动JDK，输入 sudo xattr -r -d com.apple.quarantine /$jdkPath 即可， $jdkPath 是你的jdk目录