# 外部工具

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (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)   Add   `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)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (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)), `⌘ ⌥ ⌫` (Xcode), `Ctrl+L` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+L` (ReSharper), `⌘ ⇧ L` (ReSharper (macOS)), `Shift+Delete` (QtCreator), `⇧ ⌦` (QtCreator (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)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (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)), `⌥ ↑` (Xcode), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (ReSharper), `⌥ ↑` (ReSharper (macOS)), `Alt+Up` (QtCreator), `⌥ ↑` (QtCreator (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)), `⌥ ↑` (Xcode), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (ReSharper), `⌥ ↑` (ReSharper (macOS)), `Alt+Up` (QtCreator), `⌥ ↑` (QtCreator (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)

名称
: 将在 CLion 界面中用作运行该工具操作的工具名称。

组
: 此工具所属组的名称。

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

## 工具设置

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

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

参数
: 传递给可执行文件的参数，就像您在命令行中指定它们一样。
:
:
:
: * 请使用空格分隔各个参数。
:
: * 对于包含空格的参数和路径使用双引号。
:
: * 使用反斜杠来转义作为参数或路径一部分的双引号。
:
:
:
: 例如：
:
:
:
:
: ```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)

### 参考

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

