WebStorm 2025.2 Help

外部工具

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

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

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

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

  • 本地工具在您的计算机上本地运行。

  • 远程工具通过 SSH 在远程服务器上执行。

添加本地外部工具

该示例演示如何将 ImageOptim 添加为外部工具,并将其用于优化项目中的图像。

  1. Ctrl+Alt+S 打开设置,然后选择 工具|外部工具

  2. 单击 添加按钮 并指定该工具的设置。

    “创建工具”对话框

    有关更多信息,请参阅 外部工具

    在我们的示例中,将以 ImageOptim-o4 $FilePath$ 参数运行它。 您可以使用宏,它们可引用项目名称、当前文件路径等。 单击 插入宏图标 会打开 对话框,其中列出了所有可用宏及其对应值。

  3. 单击 确定 添加该工具,然后应用更改。

运行已添加的本地外部工具

要在新添加的工具 image 中打开选定的文件,请执行以下任一操作:

  • 在主菜单中,转到 工具 | 外部工具 | <Tool name>。 在示例中,转到 工具|外部工具|图像优化器

  • 项目 工具窗口中右键点击一个文件,并在上下文菜单中选择 外部工具 | <Tool name>。 在示例中,选择 外部工具|图像优化器

    运行外部工具
  • 创建用于运行该工具的快捷键。

    Ctrl+Alt+S 打开设置,然后选择 键位映射。 在 外部工具 节点下找到 图像优化器 操作,并为其分配快捷键。

    创建外部工具:为工具栏添加图标
  • 添加图标以从工具栏运行该工具。

    1. Ctrl+Alt+S 打开设置,然后选择 外观与行为|菜单与工具栏

    2. 在可用菜单和工具栏列表中,展开 主工具栏 节点,选择要在其后添加 Image Optimizer 图标的项目,然后单击 添加

    3. 在打开的对话框中,选择 外部工具|图像优化器 ,指定用于在 图标字段 中显示的图标,并在准备就绪后点击 设置图标

      创建外部工具:工具图标已添加到工具栏

    图标将显示在工具栏中。

    创建外部工具:工具图标已添加到工具栏

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

添加远程外部工具

远程 SSH 外部工具的配置方式与本地外部工具类似,但还需定义其所运行的远程服务器,并提供用于通过 SSH 连接的凭据。 有关使用内置 SSH 终端的详细信息,请参阅 运行 SSH 终端

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 工具|远程 SSH 外部工具

  2. 单击 添加按钮 以打开 创建工具 对话框。

    添加远程外部工具

    此对话框提供与添加 本地外部工具 时相同的设置集,还允许您选择远程连接。 如果您未指定连接设置,WebStorm 每次在服务器上运行该工具时都会请求主机、端口和相关 SSH 凭据。 如需了解详细信息,请参阅 远程 SSH 外部工具

  3. 单击 确定 以添加该工具,然后应用更改。

在远程服务器上运行已添加的工具

请执行以下操作之一:

  • 在主菜单中,转到 工具| 远程工具 并选择所添加的远程外部工具的名称。

  • 创建一个快捷键以运行该工具。

    按下 Ctrl+Alt+S 以打开设置,然后选择 键位映射。 查找已配置的远程外部工具名称对应的操作,并为其分配一个快捷键。

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

最后修改日期: 2025年 9月 26日