# 外部工具

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

将第三方命令行应用程序配置为外部工具以从 IntelliJ IDEA 运行它们。

例如，您的工作流程可能需要运行特定的 script、code generator、analyzer、preprocessor 或 postprocessor、一些 database utility 等等。 通过将其配置为外部工具，IntelliJ IDEA 为其提供了一个专用操作，您可以从主菜单、某些上下文菜单中运行它、为其分配快捷键，或在启动特定运行配置时运行它。

您可以使用 [内置 IDE 宏](built-in-macros.html) 向工具传递上下文相关的命令行参数，例如当前文件或您的项目源路径。 如果必要，IntelliJ IDEA 将会在控制台打印工具的输出。

IntelliJ IDEA 支持以下类型的外部工具：

* Local tools 在您的电脑上本地运行。

* Remote tools 在远程服务器上通过 SSH 执行。 > **Note:** > 只有在 IntelliJ IDEA 旗舰版 中才能添加和运行 remote tools。

Procedure: 添加本地外部工具

此示例演示如何将 [Emacs](https://www.gnu.org/software/emacs/manual/html_node/emacs/index.html) 添加为外部工具，并使用它在项目中打开和编辑文件。

1. 按 `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)) 打开设置，然后选择  `工具 | 外部工具` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)并指定工具的设置。

![创建工具对话框](https://resources.jetbrains.com/help/img/idea/2026.3/settings_tools_external_tools_dialog.png)

有关更多信息，请参见 [外部工具设置](settings-tools-external-tools.html)。

> **Tip:**
> 点击 ![插入宏图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAdd.svg)以插入一个 [内置 IDE 宏](built-in-macros.html)，其中包含当前文件的名称或路径、项目源代码路径等。 这个示例使用  `$FilePath$`  和  `$FileDir$` 。

3. 点击   OK   添加工具，然后应用更改。

Procedure: 运行新增的本地外部工具

要在新添加的  Emacs  工具中打开选定的文件，请执行以下操作之一：

* 在主菜单中，转到  `工具 | 外部工具 | Emacs` 。

* 在   项目   工具窗口中右键点击一个文件，然后从上下文菜单中选择  `外部工具 | Emacs` 。

* 创建一个快捷方式来运行该工具。

按 `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)) 打开设置，然后选择  `按键映射` 。 在   外部工具   节点下找到   Emacs   操作，并为其分配一个快捷键。

运行该工具时，所选文件将在单独的窗口中打开。

![运行外部工具](https://resources.jetbrains.com/help/img/idea/2026.3/ij_run_external_tool.png)

Procedure: 添加远程外部工具

此功能仅在 IntelliJ IDEA Ultimate 中可用

> **Warning:**
> 确保已安装并启用  FTP/SFTP/WebDAV 连接 和  HTTP 客户端 插件。 按 `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)) 打开设置，然后选择  `插件` 。

远程 SSH 外部工具的配置与本地外部工具类似，但还需要定义执行这些工具的远程服务器，并需要通过 SSH 连接到该服务器的凭证。

此示例演示了如何将  `日期`  作为通过 SSH 在远程服务器上执行的远程 SSH 外部工具并返回其当前日期和时间。

1. 按 `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)) 打开设置，然后选择  `工具 | 远程 SSH 外部工具` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)以打开   创建工具  对话框。

![创建工具对话框](https://resources.jetbrains.com/help/img/idea/2026.3/remote-ssh-external-tools-create-dialog.png)

此对话框提供了与您添加 [local external tool](#local-ext-tools)时相同的设置集，但还允许您选择远程连接。 如果您不指定连接设置，每次在服务器上运行该工具时，IntelliJ IDEA 都会要求您提供主机、端口和相关的 SSH 凭证。 更多信息请参阅 [远程外部工具设置](settings-tools-remote-ssh-external-tools.html)。

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

3. 点击   OK   添加工具，然后应用更改。

Procedure: 在远程服务器上运行新增的工具

此功能仅在 IntelliJ IDEA Ultimate 中可用

请执行以下操作之一：

* 在主菜单中，转到  `工具 | 远程工具` 并查看所添加的远程外部工具的名称。

* 创建一个快捷方式来运行该工具。

按 `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)) 打开设置，然后选择  `按键映射` 。 找到已配置的远程外部工具的名称，并为其分配一个快捷键。

指定主机、端口和凭证后，IntelliJ IDEA 将通过 SSH 连接到服务器并运行  `日期` 命令，将输出返回到 IntelliJ IDEA 中的   运行  工具窗口。

## Web 浏览器

您可以使用网络浏览器打开项目中的任何文件。 默认情况下，它用于预览 HTML 文件的输出或运行和调试 web 应用程序。

Procedure: 在网页浏览器中打开文件

要打开打算由网页浏览器渲染的文件（HTML、XML、JSP 等），请执行以下操作之一：

* 在编辑器中打开文件，然后按 `Alt+F2` (Windows), `⌥ F2` (macOS), `⌥ F2` (IntelliJ IDEA Classic (macOS)), `⌥ F2` (macOS System Shortcuts), `Alt+F2` (XWin), `Alt+F2` (GNOME), `Alt+F2` (KDE), `Alt+F2` (Emacs), `Alt+F2` (Sublime Text), `Alt+F2` (Sublime Text (macOS)), `Alt+F2` (Visual Studio), `⌥ F2` (Visual Studio (macOS)), `Alt+F2` (NetBeans), `Alt+F2` (Eclipse), `⌥ F2` (Eclipse (macOS))。

* 在 [Project tool window](project-tool-window.html) 中右键点击文件，然后选择   在浏览器中打开  。

* 在主菜单中，前往   查看 | 在浏览器中打开  。

* 请使用编辑器窗口右上角的浏览器弹出窗口（悬停时出现）。 点击浏览器按钮，以打开  web 服务器 文件 URL；或 `Shift+Click` (Windows), `Shift+Click` (macOS), `Shift+Click` (IntelliJ IDEA Classic (macOS)), `Shift+Click` (macOS System Shortcuts), `Shift+Click` (XWin), `Shift+Click` (GNOME), `Shift+Click` (KDE), `Shift+Click` (Emacs), `Shift+Click` (Sublime Text), `Shift+Click` (Sublime Text (macOS)), `Shift+Click` (Visual Studio), `Shift+Click` (Visual Studio (macOS)), `Shift+Click` (NetBeans), `Shift+Click` (Eclipse), `Shift+Click` (Eclipse (macOS))它以打开  本地 文件 URL。

![编辑器中的 Browser 弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/editor-browser-popup.png)

对其他文件类型不可用   在浏览器中打开  操作。 但是，您仍然可以使用   查找操作   `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))执行它。

Procedure: 查看并配置浏览器列表

> **Note:**
> 默认情况下，IntelliJ IDEA 支持一些最最受欢迎的的浏览器，如果可用，将自动配置。

* 在   设置  对话框（ `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))）中，选择   工具 | Web Browsers 和预览  。

![“设置”中的“Web 浏览器”页面](https://resources.jetbrains.com/help/img/idea/2026.3/settings-tools-web-browsers.png)

如果浏览器是使用标准程序安装的，   路径   字段中的别名应指向正确的位置。 如果没有，请指定对应可执行文件的路径。

> **Tip:**
> 要添加自定义浏览器，请点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)并指定浏览器名称、类别及可执行文件或 macOS 应用程序的位置。

Procedure: 使用自定义配置文件和设置

您可以为 Firefox 和 Chrome 系列浏览器配置自定义配置文件。

1. 在   设置  对话框（ `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))）中，选择   工具 | Web Browsers 和预览  。

2. 在列表中选择浏览器，然后点击 ![编辑按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)。

* 对于 Firefox，请指定 `profiles.ini` 文件的路径并选择要使用的配置文件。 如需更多信息，请参阅 [Firefox browser profile](http://support.mozilla.com/en-US/kb/Profiles)。

* 对于 Chrome，选择 使用自定义用户数据目录 并指定 [用户数据目录](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md)的位置。 您还可以在从 IntelliJ IDEA 运行 Chrome 时指定其他命令行选项。 如需更多信息，请在 Chrome 地址栏中打开 `chrome://flags` 。

## See also

### 相关

[外部工具设置](settings-tools-external-tools.html) [远程外部工具设置](settings-tools-remote-ssh-external-tools.html) [Web 浏览器和预览](settings-tools-web-browsers.html) [内置 IDE 宏](built-in-macros.html)