# 运行/调试配置

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

> **TL;DR**
> 配置：  `运行 | 编辑配置`

IntelliJ IDEA 使用运行/调试配置来运行、调试和测试您的代码。 每个配置是一组命名的启动属性，用于定义要执行的内容以及应使用的参数和环境。

> **Tip:**
> 要快速开始运行和调试 Java 应用程序，请参考以下教程：
>
> * [运行 Java 应用程序](run-java-applications.html)
>
> * [调试 Java 应用程序](debugging-your-first-java-application.html)

有两种 运行/调试 配置：

* 临时 — 在 [运行没有永久配置的类](running-applications.html#quick-way)时创建。 它提供了使具有 `main()` 方法的类运行的最低要求。

* 永久 —由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分，直到您删除它们。

每当您运行、调试或测试代码时，IntelliJ IDEA 要么使用现有的永久运行/调试配置，要么创建一个新的临时配置。

永久配置的图标是不透明的，而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

![永久配置和临时配置有不同的图标](https://resources.jetbrains.com/help/img/idea/2026.3/rc_icons.png)

临时配置的最大数量为 5。 添加新版本时，旧版本会被自动删除。 如有必要，您可以在  `设置 | 高级设置 | 运行/调试 | 临时配置限制` 中增加此限制。

## 创建永久运行/调试配置

IntelliJ IDEA 提供以下方法来创建永久运行/调试配置：

* 当有可执行的类或方法时，您可以 [直接从编辑器创建永久运行/调试配置](#from-class)。

* [将临时运行/调试配置保存为永久配置](#save-as-permanent)。

* [从模板创建](#createExplicitly)或复制现有配置。

Procedure: 从可执行方法或类创建永久运行/调试配置

1. 将文本光标置于可执行方法或类（例如，带有  `main()`  方法的类或测试套件）的声明处，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

2. 从打开的菜单中，选择   修改运行配置  。

IntelliJ IDEA 创建一个对应类型的永久运行/调试配置，并打开一个对话框，您可以在其中设置配置参数。

![为类创建运行配置](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置列表](list-of-run-debug-configurations.html)。

Procedure: 将临时配置保存为永久配置

* 在 [运行微件](guided-tour-around-the-user-interface.html#toolbar) 中选择一个临时配置，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg) 并选择   保存配置  。

![保存临时运行配置](https://resources.jetbrains.com/help/img/idea/2026.3/save_temporary.png)

* 或者，在“运行/调试配置”对话框中选择一个临时配置，然后点击工具栏上的 ![保存](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.save.svg)。

IntelliJ IDEA 为不同的语言、工具和框架提供运行/调试配置 [模板](#templates)。 可用模板的列表会因已安装和启用的 [plugins](managing-plugins.html) 而有所不同。

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/help/img/idea/2026.3/app.expui.general.add.svg)，或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))。 该列表显示运行/调试配置模板。 请选择一个模板，例如   应用程序  。 此配置编译并运行您的 Java 程序——类似于使用  `javac`  和  `java`  命令。

![选择新的运行/调试配置模板](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置模板列表](list-of-run-debug-configurations.html)（其他运行配置）。

5. 您可以立即运行该配置，或保存该配置以便稍后运行。

* 要保存运行配置以供稍后使用，请点击 OK 。

* 要立即运行该配置，请点击 运行 。

## 启动运行配置

Procedure:

可以通过以下任一方式启动现有运行配置：

* 如果已在 [运行微件](guided-tour-around-the-user-interface.html#toolbar) 中选择运行配置，请点击其旁边的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)，或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))。

![运行微件旁的"Run"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/launch-rc-from-run-widget.png)

* 如果想选择其他运行配置，请点击 [运行微件](guided-tour-around-the-user-interface.html#toolbar)。 在打开的菜单中，点击要启动的运行配置旁边的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)。

![运行微件菜单中运行配置旁的"Run"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/select-rc-from-run-widget.png)

* 按下 `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))。 在打开的菜单中，点击您想启动的运行配置。

## 共享运行/调试配置

您可能希望共享您的 运行/调试 配置，以便团队成员可以使用相同的配置运行应用程序，或者启用他们远程附加到您正在运行的进程。

IntelliJ IDEA 提供了一种机制，可以将您的 运行/调试 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时，也可以使用相同的机制。

传统  `.ipr` -based 项目不支持单独的 运行/调试 配置。 对于传统项目，您只能通过将  `.ipr` 文件添加到 VCS 来一次性共享所有配置。

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. 请选择您要共享的 运行/调试 配置，启用   存储为项目文件  选项，并指定配置文件的存储位置。

您可以配置任何位置，除非需要与 IntelliJ IDEA 2019.3 及更早版本兼容。 为了与这些版本兼容，请将文件存储在建议的位置。

3. （可选）如果将  `.idea` 目录添加到 VCS 忽略文件中，那么  `.idea/runConfigurations` 子文件夹也将被忽略。 如果项目使用 Git，您可以共享  `.idea/runConfigurations`  并保留  `.idea`  被忽略，通过修改  `.gitignore`  如下：

```
/.idea/*
!/.idea/runConfigurations

```

> **Note:**
> 启用   存储为项目文件   选项不会将任何内容提交到 VCS。 为了使 运行/调试 配置进入共享存储库，您必须像其他版本化文件一样将它们签入。

## 运行/调试配置模板

所有运行/调试配置都基于模板，这些模板实现了启动逻辑，定义参数列表及其默认值。 安装中预定义了 [可用模板列表](list-of-run-debug-configurations.html)，只能通过 [插件](managing-plugins.html)进行扩展。 但是，您可以编辑每个模板中的默认参数值，以便于新运行/调试配置的设置。

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/help/img/idea/2026.3/ij_Run_Debug_create.png)

3. 在打开的   运行/调试配置模板  对话框中，选择一个配置类型。

![运行/调试模板](https://resources.jetbrains.com/help/img/idea/2026.3/ij_Run_DebugDefaults.png)

4. 请指定所需的默认参数，然后点击   OK   以保存模板。

> **Tip:**
> 您可以像常规运行/调试配置一样与您的团队成员 [共享运行/调试配置模板](#share-configurations)。

## 运行/调试配置文件夹

当有许多相同类型的 运行/调试 配置时，您可以将它们分组到文件夹中以便于访问。

![分组运行配置](https://resources.jetbrains.com/help/img/idea/2026.3/rc_folders.png)

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/help/img/idea/2026.3/app.expui.actions.newFolder.svg)。

![在文件夹中分组配置](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置对话框](run-debug-configurations-dialog.html)