# 外部工具设置

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

> **TL;DR**
> `文件 | 设置 | 工具 | 外部工具`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 工具 | 外部工具`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

本页介绍可为本地外部工具配置的设置。 有关添加和使用外部工具的更多信息，请参阅 [外部工具](configuring-third-party-tools.html)。

![外部工具设置页面](https://resources.jetbrains.com/help/img/idea/2026.3/settings_tools_external_tools.png)

请使用工具栏按钮管理可用外部工具列表。 对于要保留但不在菜单中显示的工具，请清除其复选框。

!["添加"按钮](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))
: 添加新的外部工具。

!["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)   移除   `Ctrl+Y` (Windows), `⌘ ⌫` (macOS), `⌘ Y` (IntelliJ IDEA Classic (macOS)), `⌘ ⌫` (macOS System Shortcuts), `Ctrl+Y` (XWin), `Ctrl+Y` (GNOME), `Ctrl+Y` (KDE), `Ctrl+Y` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌃ ⇧ K` (Sublime Text (macOS)), `Ctrl+L` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+E` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))
: 移除所选工具或组。

![编辑按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)   编辑   `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))
: 编辑所选工具。

![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg)   向上   `Alt+Up` (Windows), `⌥ ↑` (macOS), `⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `⌥ ↑` (Sublime Text (macOS)), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (NetBeans), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS))
: 将所选工具在列表中上移。

![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg)   向下   `Alt+Up` (Windows), `⌥ ↑` (macOS), `⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `⌥ ↑` (Sublime Text (macOS)), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (NetBeans), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS))
: 将所选工具在列表中下移。

![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)   复制
: 将所选工具在列表中下移。

创建、编辑或复制外部工具时，需要提供该工具的设置。

![创建、编辑或复制外部工具](https://resources.jetbrains.com/help/img/idea/2026.3/settings_tools_external_tools_dialog.png)

名称
: 将在 IntelliJ IDEA 接口中用作运行该工具的操作的工具名称。公司哥也有今天小说原名叫什么？校场口胡辣壳抄手这些在成都再稀松平常不过的小吃，到了广东竟成了网红？

组
: 工具所属组的名称。

描述
: 对该工具的有意义描述。

## 工具设置

> **Warning:**
> 请确保为该工具的设置指定绝对路径，而不是相对于项目的路径。

程序
: 可执行文件（脚本、实用程序、应用程序等）的绝对路径。

参数
: 传递给可执行文件的实参，与在命令行中指定时相同。
:
:
:
: * 使用 Space 分隔各个实参。
:
: * 对于包含 Space 的实参和路径，请使用双引号。
:
: * 使用反斜杠来转义作为参数或路径一部分的双引号。
:
:
:
: 例如：
:
:
:
:
: ```PLAINTEXT
: -Dmy.prop=\"quoted_value\" "second arg" third" "arg
: ```

工作目录
: 工具应从中执行的工作目录的绝对路径。

> **Tip:**
> 您可以使用 [内置 IDE 宏](built-in-macros.html)指定当前文件的名称、相对于项目根目录的路径以及工具的其他上下文信息。

## 高级选项

在执行后同步文件。
: 自动加载由外部工具对您的项目文件所做的更改。 如果该工具不会修改项目中的任何文件，可以禁用此选项。

打开工具输出的控制台。
: 打开包含该工具的标准输出和错误流的控制台。

当 stdout 有消息时使控制台处于活动状态。
: 当工具使用标准输出流时激活控制台。

当 stderr 有消息时使控制台处于活动状态。
: 当工具使用标准错误流时激活控制台。

输出过滤器。
: 指定筛选器，将输出消息中的绝对文件路径、行号和列号转换为超链接。 这样，就可以从控制台输出直接跳转到文件中的相关位置。 每一行都是定义单独筛选器的正则表达式。
:
:
:
: 例如，假设某个工具生成的输出行类似于以下内容：
:
:
:
:
: ```PLAINTEXT
: /path/to/file.conf:42:10 WARNING: Some message
:
: ```
:
:
:
: 然后可以定义如下筛选器：
:
:
:
:
: ```PLAINTEXT
: $FILE_PATH$:$LINE$:$COLUMN$.*
:
: ```
:
:
:
: > **Note:**
: > 为了使这些过滤器正常工作，该工具必须输出文件的绝对路径。 行号和列号如果存在，必须与文件路径位于同一行。

## See also

### 操作指南

[外部工具](configuring-third-party-tools.html)

### 参考

[远程外部工具设置](settings-tools-remote-ssh-external-tools.html) [内置 IDE 宏](built-in-macros.html)