WebStorm 2025.2 Help

比较文件、文件夹与文本源

WebStorm 允许您查看任意文件(Ctrl+D )、文件夹与文本源之间的差异,也可查看本地文件与其版本库版本之间的差异。

比较文件

比较两个或三个文件

  • 项目 工具窗口 Alt+1 中,选择要比较的文件,然后选择 比较文件 ,或按 Ctrl+D

  • 或者,选择一个文件,从其上下文菜单中选择 比较对象… ,然后选择项目外部的另一个文件。

将活动编辑器与剪贴板比较

  • 在编辑器中任意位置右键点击,然后从上下文菜单中选择 与剪贴板比较(B)

将活动编辑器与项目文件比较

  1. 项目 工具窗口 Alt+1 中,右键点击要与当前打开文件比较的文件。

  2. 从上下文菜单中选择 与编辑器比较文件(M)

将活动编辑器与任意文件比较

如果您经常需要将项目外部的文件与活动编辑器进行比较,或不希望打开 项目 工具窗口 Alt+1 ,可以使用 与编辑器比较文件(M) 操作,选择任意文件与活动编辑器比较。

要将此操作添加到编辑器标签的上下文菜单:

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

  2. 在右侧窗格中展开 编辑器标签页弹出窗口菜单 节点,选择要添加新操作的位置,点击 添加操作菜单 并选择 添加操作(A)…

  3. 版本控制系统 | 差异与合并 中查找并添加 与编辑器比较文件(M) 操作。

将本地文件与其版本库版本进行比较

  1. 打开 提交 工具窗口 Alt+0

  2. 在变更列表中找到所需文件,然后执行下列操作之一:

    • 右键单击该文件,然后选择 Git | 显示差异

    • 选择该文件并按下 Ctrl+D

    • 双击该文件。

WebStorm 会在 Diff Viewer for Files 中显示差异:

比较文件

颜色

描述

新增行 新增行 绿色

新增

已修改行 已修改行 蓝色

已修改

已删除行 已删除行 灰色

已删除

要应用更改,请使用尖括号按钮: 应用左侧应用右侧

要追加更改,请按 Ctrl应用左侧 应用右侧 按钮将变为 右下角的尖角按钮 左下角的尖角按钮

效率提示

为“接受”和“追加”分配快捷键

要为 acceptappend 操作分配快捷键,请打开 键位映射 设置页面 Ctrl+Alt+S ,并在 版本控制系统 | 差异与合并 下找到这些操作。

交换两侧

当比较两个文件,或文件与剪贴板内容时,您可以点击工具栏上的 交换两侧按钮 来交换左右两边。

从命令行比较文件

您可以通过命令行比较两个或三个文件,并将 WebStorm 作为外部差异工具使用。 有关更多信息,请参阅 从命令行比较文件

比较文件夹

WebStorm 允许您根据文件大小、内容或时间戳比较两个文件夹中的文件。 差异将在 Diff Viewer for Folders 中显示:

比较文件夹

上方窗格列出所选文件夹中的所有文件,而下方窗格显示所选文件的两个版本之间的差异(请参阅 比较文件)。

比较文件夹

  1. 项目 工具窗口中选择要比较的文件夹 Alt+1

  2. 在上下文菜单中选择 比较目录 ,或按下 Ctrl+D

  3. 使用以下工具栏按钮筛选列表:

    • 右箭头 :点击显示出现在左侧文件夹但缺失于右侧文件夹的文件。

    • 左箭头 :点击显示出现在右侧文件夹但缺失于左侧文件夹的文件。

    • 不等号 :点击显示同时出现在两个文件夹中但内容、时间戳或大小不同的文件。

    • 等号 :点击显示同时出现在两个文件夹中,并且在 比较方式 下拉菜单中所选选项的一致性的文件。

  4. 使用搜索字段中的文本筛选器来包含或排除文件:

    • 要包含文件,请输入匹配模式。 例如, .txt 会验证所有以 .txt 结尾的路径。

    • 要排除文件,请在模式前添加 !。 例如, !build/* 排除所有位于 build 目录中的文件。

    • 使用 &AND )和 |OR )组合多个筛选条件。 例如, *.txt|.xml&!build/* 验证所有以 .txt.xml 结尾并且不位于 build 目录中的路径。

同步文件夹

WebStorm 允许您同步两个文件夹的内容,或将更改从一个文件夹应用到另一个文件夹。

  1. 对于每个文件,点击 * 列中的图标,直到设置了要对该文件执行的操作为止。

    • 右箭头 :将所选项从左侧复制到右侧文件夹。 如果右侧文件夹中已存在该文件,则会被覆盖。

    • 左箭头 :将所选项从右侧复制到左侧文件夹。 如果左侧文件夹中已存在该文件,则会被覆盖。

    • 等号 :不执行任何操作(两个文件相同)。

    • 不等号 :不执行任何操作(两个文件不同)。

    • 关闭图标 :删除所选项。

  2. 执行下列操作之一:

    • 要将所选操作应用于当前项,请点击工具栏上的 同步选中项 按钮 “同步所选”按钮 ,或按 Enter

    • 要将所选操作应用于所有项目,请点击工具栏上的 全部同步 按钮 “全部同步”按钮

比较两个文件夹中的不同文件

有时一个文件可能出现在某个文件夹中,而另一个具有相似名称的文件在另一个文件夹中(例如, VCS_library_1.4 VCS_library_1.5 )。 这些可能是您希望比较的同一文件的不同版本。 此外,也可能存在一种情况,您认为某个文件被重命名了,但实际上与另一个文件夹中的某个文件内容相同。 WebStorm 允许您比较两个文件,其中一个位于右侧文件夹,另一个位于左侧文件夹,即使这些文件被视为不同的实体。

  1. 在左侧和右侧窗格中选择要比较的文件。

  2. 单击工具栏中的 比较新文件 图标 新文件互相比对按钮。 所选文件之间的差异将显示在底部窗格中。

比较任意文本源

除了比较文件或文件夹的内容外,您还可以打开一个空的 Diff Viewer ,将任意文本粘贴或将文件拖入左右面板中进行比较。 例如,如果您希望将某个应用程序的控制台输出与该应用程序经过少量修改后的输出进行比较,这将非常有用。

  1. Ctrl+Shift+A 并开始键入以定位 打开空白差异窗口 操作。

  2. 请在左右面板中粘贴您要比较的任意文本。

    右键单击左侧或右侧面板,并选择 切换到三向查看器 以比较任意三个文本源。

效率提示

为“打开空白差异”操作分配快捷键

键位映射 设置页 Ctrl+Alt+S 中,在 版本控制系统 | 差异与合并 下定位此操作。

交换两侧

您可以通过单击工具栏上的 交换两侧 图标,交换 差异查看器 中的左右两侧。

在单独窗口中打开差异视图

默认情况下, 差异查看器 在编辑器标签页中打开。 您可以配置设置,使查看器在单独的窗口中打开。 在 高级设置 设置页 Ctrl+Alt+S 中,禁用 作为编辑器标签页打开差异 选项。

通过外部差异工具比较

您可以设置并启动外部 diff 工具,直接从 WebStorm 进行文件和更改的比较。 请确保事先在您的计算机上安装所需的 diff 工具。

配置外部差异工具

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

  2. 选择 启用外部工具 选项。

    启用外部差异工具
  3. 配置外部工具 部分中,单击

  4. 在打开的 添加外部工具 对话框中,填写以下信息:

    • 工具组 :从列表中选择 Diff tool

    • 程序路径 :指定系统中 diff 工具可执行文件的路径。

    • 实参模式 :如有必要,调整用于显示更改的模式,其中:

      • %1 - 本地更改

      • %2 - 来自远程服务器的内容

      • %3 - 未进行本地更改的当前版本

    将 kdiff3 添加为外部差异工具

    单击 测试差异测试三向差异 来验证外部 diff 工具是否能从 WebStorm 成功启动。

  5. 单击 确定 保存更改。

从 WebStorm 启动外部差异工具

  • 在 Diff Viewer 中检查差异时,单击 以让 WebStorm 启动配置的外部 diff 工具。

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