外部工具

推荐的使用第三方独立应用程序（如编译器、代码检查器、代码压缩器等）的方式是配置特定工具的 File Watcher。此 File Watcher 将跟踪文件的更改，并在需要时自动运行应用程序。有关更多信息，请参阅 File Watchers。

或者，您可以在 WebStorm 中将独立的第三方应用程序配置为外部工具。这样，特定工具的命令会被添加到主菜单中，并可能出现在上下文菜单中，因此您可以直接从 WebStorm 运行该工具。您还可以配置在运行/调试配置之前运行该工具。当然，您也可以从内置的终端 Alt+F12 运行它。

WebStorm 允许您将项目中的上下文信息作为命令行参数传递给外部工具（例如，当前选定的文件或 sourcemap 指令），并查看工具生成的输出。

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

此示例演示如何将 ImageOptim 添加为外部工具，并使用它优化项目中的图像。

按下 Ctrl+Alt+S 以打开设置，然后选择工具 | 外部工具。
点击并指定工具的设置。
有关更多信息，请参阅外部工具。
点击以插入一个内置 IDE 宏，其中包含当前文件的名称或路径、项目源代码路径等。这个示例使用 $FilePath$ 和 $FileDir$ 。
在我们的示例中， ImageOptim 将使用 -o4 $FilePath$ 参数运行。您可以使用可以引用项目名称、当前文件路径等的宏。点击将打开宏对话框，其中列出了所有可用宏及其值。
点击确定添加工具，然后应用更改。

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

在主菜单中，进入工具 | 外部工具 | <工具名称>. 在我们的示例中，转到工具 | 外部工具 | 图像优化器。
在项目工具窗口中右键点击一个文件，然后从上下文菜单中选择外部工具 | <工具名称>。在我们的示例中，选择外部工具 | 图像优化器。
创建一个快捷方式来运行该工具。
按下 Ctrl+Alt+S 打开设置，然后选择按键映射。在外部工具节点下找到图像优化器操作，并为其分配一个快捷键。
添加一个图标以从工具栏运行工具。
1. 按下 Ctrl+Alt+S 打开设置，然后选择外观 & 行为 | 菜单和工具栏。
2. 在可用菜单和工具栏列表中，展开主工具栏节点，选择您希望在其后添加 Image Optimizer 图标的项目，然后点击添加。
3. 在打开的对话框中，选择外部工具 | 图像优化器，指定图标以在图标字段中指示它，并在准备好后点击设置图标。
图标会出现在工具栏上。

运行工具时，输出会显示在运行工具窗口中。

远程 SSH 外部工具的配置与本地外部工具类似，但还需要定义执行这些工具的远程服务器，并需要通过 SSH 连接到该服务器的凭证。有关使用内置 SSH 终端的更多信息，请参阅运行 SSH 终端。

按下 Ctrl+Alt+S 以打开设置，然后选择工具 | 远程 SSH 外部工具。
点击以打开创建工具对话框。
此对话框提供了与您添加 local external tool时相同的设置集，但还允许您选择远程连接。如果您不指定连接设置，每次在服务器上运行该工具时，WebStorm 都会要求您提供主机、端口和相关的 SSH 凭证。欲了解更多信息，请参阅远程 SSH 外部工具。
您可以使用内置 IDE 宏指定当前文件的名称、相对于项目根目录的路径以及工具的其他上下文信息。
点击 OK 添加工具，然后应用更改。

请执行以下操作之一：

在您指定主机、端口和凭据后，WebStorm 将通过 SSH 连接到服务器并运行命令，并将输出返回到 WebStorm 中的运行工具窗口。

最后修改日期： 2025年 12月 8日