# 教程：远程调试

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

在本教程中，我们将学习如何使用 IntelliJ IDEA 调试器附加到本地或远程进程。 它将带领您完成一个基本的远程调试场景，帮助您快速入门。

> **Tip:**
> 如果需要完整的远程调试设置和功能说明，请参阅 [附加到进程](attach-to-process.html)。

## 概述

远程调试让您可以像在本地一样控制和检查在另一台计算机上运行的 Java 程序。

为此，首先在远程计算机上启动应用程序，并通过添加一个特殊的虚拟机选项将其配置为接受调试器连接。 该选项会使远程 JVM 等待来自调试器的传入连接。

一旦远程应用程序启动并开始侦听，您可以在本地计算机上以"附加"模式启动调试器。 这会通过网络将 IntelliJ IDEA 的调试器连接到远程应用程序，从而允许对其进行调试。

> **Note:**
> 为简单起见，我们将在同一台计算机上启动调试器和主机应用程序。 不过，对于实际的远程调试，这些步骤是相同的，因此可以在两种场景中使用相同的过程。

## 创建项目

首先，让我们设置将要调试的项目——一个简单的程序，它会输出从  `A`  到  `Z`  的大写字母。

> **Tip:**
> 您可以使用自己的项目，而不是在本章中创建的项目。 如果您这样做，请确保：
>
>
>
> * 此应用程序已使用调试信息编译。 这是默认的编译器设置，不得覆盖。 否则，大多数调试器功能将不可用。
>
> * 您拥有该应用程序的源代码。 尽管可以使用反编译代码进行调试，但过程更为复杂，并且本教程中不涵盖此内容。

Procedure:

1. [创建新项目](creating-and-running-your-first-java-application.html#create-project)。

2. 创建一个名为  `字母表`  的类。

![在 Project 工具窗口中的 Alphabet.java](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_project_1.png)

3. 在  `字母表`  类的主体中，粘贴以下  `main`  方法的定义：

```JAVA
public static void main(String[] args) {
    System.out.println("Starting");
    for (char c = 'A'; c < 'Z'; c++) {
        try {
            Thread.sleep(2500);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        System.out.println(c);
    }
    System.out.println("Complete");
}

```

## 创建运行配置

为了允许调试器附加，我们需要使用特殊参数运行应用程序（稍后会详细介绍）。 在本教程中，我们将设置一个运行/调试配置来为我们执行此操作。 这样，我们将有两个运行/调试配置： [一个用于运行应用程序](#host_rc)， [另一个用于附加到它](#debugger_rc)。

### 设置调试器

首先，我们需要设置运行/调试配置，以便附加到主机应用程序。

Procedure:

1. 在主菜单中，转到  `运行 | 编辑配置` 或按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS))然后 `0` (Windows), `0` (macOS), `0` (IntelliJ IDEA Classic (macOS)), `0` (macOS System Shortcuts), `0` (XWin), `0` (GNOME), `0` (KDE), `0` (Emacs), `0` (Sublime Text), `0` (Sublime Text (macOS)), `0` (Visual Studio), `0` (Visual Studio (macOS)), `0` (NetBeans), `0` (Eclipse), `0` (Eclipse (macOS))。

2. 在   运行/调试配置  对话框中，点击   添加新配置  按钮 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并选择   远程 JVM 调试  。

![“运行/调试配置”对话框左上角的“添加新配置”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_rc_1.png)

3. 配置/使用以下属性：

* 名称 ：为此运行/调试配置定义一个方便的名称或保留默认值。

* 主持人 ：主机应用程序将运行的机器地址。 由于我们在同一台机器上运行它，因此它需要是 `本地主机` 。 如果该程序在其他机器上运行，您可以在此处指定其地址，例如： `192.168.17.43` 。 > **Note:** > 默认端口（5005）无需更改。 但是，请确保它未被占用且未被防火墙阻止。

* 远程 JVM 的命令行参数 ：启动主机应用程序所需的 VM 选项。 我们将在其他运行/调试配置中使用它们。 您可以现在复制它们，或者稍后再回到这个字段。

![远程 JVM 字段的 Name、Host 和 Command line arguments](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_rc_2.png)

4. 点击   应用  。

### 设置主机应用程序

主应用程序的运行方式没有任何限制。 例如，您可以 [将应用程序打包为 JAR](compiling-applications.html#package_into_jar)，并使用以下命令行运行它：

```SHELL
java -jar -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 remote-debug.jar
            
```

> **Note:**
> 为了调试的目的，只要应用程序获得启动程序并附有调试代理的 VM 选项，那么我们如何运行应用程序并没有区别。

在本教程中，我们将使用一个 run/debug 配置，它将为我们完成大部分工作。

Procedure:

1. 右键点击  `字母表`  类主体的任意位置。 选择   更多运行/调试  ，然后   修改运行配置  。

2. 点击   修改选项  ，然后选择   添加 VM 选项  。 请在   VM 选项   字段中粘贴您从 [调试配置](#debugger_rc) 中复制的选项。

![主机应用运行/调试配置中的 VM options 字段](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_rc_3.png)

3. 点击   应用  。

## 运行应用程序

现在我们已经准备好所有必要的东西，可以继续运行我们的应用程序。

Procedure:

* 按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS))并选择  `字母表` 。

![运行弹出窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_run_1.png)

在程序输出中，第一行将是：

```SHELL
Listening for transport dt_socket at address: 5005

```

这表示我们已启用了调试代理程序并且我们的程序已经准备好接受传入的调试器连接。

如果该行未出现，请确保端口未被其他应用程序使用或未被防火墙或安全设置阻止。

## 附加到进程

Procedure:

1. 点击第 10 行的边距以在此处设置行断点。

![在第 10 行设置行断点](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_run_2.png)

2. 按 `Alt+Shift+F9` (Windows), `⌃ ⌥ D` (macOS), `⌥ ⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ D` (macOS System Shortcuts), `Alt+Shift+F9` (XWin), `Alt+Shift+F9` (GNOME), `Alt+Shift+F9` (KDE), `Alt+Shift+F9` (Emacs), `Alt+Shift+F9` (Sublime Text), `⌃ ⌥ D` (Sublime Text (macOS)), `Alt+Shift+F9` (Visual Studio), `⌃ ⌥ D` (Visual Studio (macOS)), `Alt+Shift+F9` (NetBeans), `Alt+Shift+F9` (Eclipse), `⌃ ⌥ D` (Eclipse (macOS)) 并选择您的远程调试配置。

![调试 弹窗](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_run_3.png)

结果是，程序在断点处暂停，您可以执行任何调试操作，如 [单步执行](stepping-through-the-program.html)、 [表达式求值](examining-suspended-program.html#evaluating-expressions)等。

![蓝色高亮表示程序在第 10 行暂停](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_run_4.png)

不管应用程序如何及在哪里启动，调试过程都是相同的。 连接后，您可以使用与直接从 IntelliJ IDEA 启动应用程序时相同的调试功能。

## 关闭调试会话

Procedure:

1. 关闭   调试   工具窗口中对应的会话选项卡。

![在调试工具窗口顶部的当前会话标签](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_disconnect_0.png)

2. 选择是否终止该进程或与其断开连接。

* 断开连接 停止调试会话，而进程继续运行

* 终止 同时停止进程和调试会话

![弹出窗口正在询问您是仅停止会话（Disconnect），还是同时停止会话和进程（Terminate）](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_remote_tutorial_disconnect_1.png)

> **Tip:**
> 如果您只想断开调试器而不终止进程，请点击调试器工具栏上的   停止   ![停止按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.run.stop.svg)。

