WebStorm 2025.2 Help

文件差异查看器

当您比较两个文件或同一文件的两个版本(本地更改,或本地文件与其在远程存储库中的修订版本之间的更改)时,将显示此差异查看器。 您可以比较任何类型的文件,包括二进制和 .jar 文件。 要打开该工具,请选择要比较的两个文件或一个文件以比较其版本,然后按下 Ctrl+D。 差异查看器将在新选项卡中打开。

差异查看器提供强大的编辑器,支持代码补全、实时模板等功能。

您在差异查看器中应用的更改会自动应用到文件中。 在使用差异查看器的过程中以及关闭之后,您都可以随时查看文件中的更改。

差异与合并查看器

工具提示与快捷键

描述

上一个差异按钮/下一个差异按钮

上一个差异 / 下一个差异 Shift+F7 F7

跳转到上一个或下一个差异。

当到达最后一个或第一个差异时, WebStorm 会建议单击箭头按钮,或再次按 F7/Shift+F7 并比较其他本地已修改的文件。 此行为取决于 到达最后更改后转到下一个文件选项,在 差异查看器设置中进行配置。

比较上一个文件图标

比较下一个文件图标

比较上一个/下一个文件

Alt+Left Alt+Right

将上一个或下一个文件的本地副本与其来自服务器的更新版本进行比较。

转到已更改文件图标

转到已更改的文件 Ctrl+N

显示当前变更集中的所有更改文件并跳转到该文件。仅在审阅多个文件更改时可用此操作。 仅在审阅多个文件更改时可用此操作。

跳转到源代码按钮

跳转到源(J)

F4

在编辑器中打开所选文件。 光标将定位在与 差异查看器 中相同的位置。

查看器

选择查看器模式:并排或统一。并排模式具有两个面板,统一模式具有一个面板。 并排模式具有两个面板,统一模式具有一个面板。

您可以在两个查看器中编辑代码并执行 接受追加还原 操作。

仅可在并排查看器的右侧部分或统一查看器的下行中更改文本。

您只能编辑文件的本地版本。 无法编辑具有只读状态的文件。

空格字符

定义差异查看器如何处理空格字符。

  • 不忽略 :空格字符很重要,所有差异都会被高亮显示。 此选项为默认选中。

  • 修整空白 :当空格字符出现在行首或行尾时将其截断(("\t", " "))。

    • 如果两行仅在行尾空格处存在差异,则认为它们是相同的。

    • 如果两行存在差异,行尾空格在 按单词模式下不会高亮。

  • 忽略空格 :空格字符不重要,无论其在源代码中的位置如何。

  • 忽略空格和空行 :忽略空格字符和空行。 会忽略以下实体:

    • 所有空格字符(与“忽略空格字符”选项相同)

    • 所有仅包含空格字符的新增或删除行

    • 所有仅由拆分或合并行组成的更改,且非空格部分无更改。

      例如,在此模式下, a b ca \n b c 之间的差异不会突出显示。

高亮模式

选择用于突出显示差异细粒度的方式。

可用的选项包括:

  • 高亮显示单词 :已修改的单词将被突出显示

  • 高亮显示行 :已修改的行将被突出显示

  • 高亮显示拆分的更改 :如果选择此选项,大的更改将被拆分为更小的更改。

    例如, A \n BA X \n B X 会被视为两个更改,而不是一个。

  • 高亮显示字符 :已修改的符号将被突出显示

  • 不高亮显示 :如果选择此选项,差异将完全不会被突出显示。

    在处理已被显著修改的文件时,请使用 不高亮显示 选项。 在此类情况下,高亮可能在评审过程中带来额外干扰。

折叠未更改片段图标

收起未更改的片段

折叠两个文件中所有未更改的片段。 未折叠的未更改行数可在 差异与合并 设置页中进行配置。 要打开 差异与合并 页面,请按下 Ctrl+Alt+S 打开设置,并导航至 工具 | 差异与合并。 。

同步按钮

同步滚动

单击此按钮以同时滚动两个差异窗格。 如果取消选中此按钮,每个窗格将能够独立滚动。

设置按钮

设置

打开可用设置的列表。

这些命令也可通过 Diff Viewer 边距的上下文菜单访问。

交换侧边按钮

交换两侧

点击此按钮可在 Diff Viewer 中互换两侧。 此操作在比较两个文件、文件与剪贴板内容或在空白 Diff Viewer 中粘贴要比较的内容时可用。 有关详细信息,请参见 比较文件、文件夹与文本源

包含到提交中 Alt+I

仅当您从 提交更改对话框 调用 差异查看器 时且多个已更改的文件全部未选中,并在它们之间浏览差异并浏览至某文件的最后一个差异时,此复选框才会出现。

如果希望在提交中包含您已查看的文件,请选中此复选框。

帮助图标

帮助

F1

打开浏览器并显示相应的帮助页面。

Ctrl+Shift+Tab

在 Diff Viewer 的窗格之间切换。 活动窗格包含插入符号。

应用左侧 应用右侧

接受

在窗格之间(对并排查看器)或在行之间(对统一查看器)应用差异。

双向箭头按钮的行为可能会变化:

  • 点击 应用左侧应用右侧 以应用更改。 此行为为默认行为。

  • Ctrl 可将 应用左侧应用右侧 更改为 向右下角的折线按钮向左下角的折线按钮 ,并附加更改。

合并操作

比较内容图标

比较内容

点击此图标以调用选项列表,允许您比较文件的不同版本来解决冲突。

请注意, 基准 表示本地版本与代码库版本来源的文件版本(最初显示在中间窗格中),而 中间 表示合并后的版本。

应用无冲突更改按钮

应用所有非冲突更改

单击此按钮可应用所有非冲突更改。 您还可以在设置对话框的 Diff & Merge 页面中选中复选框 自动应用无冲突的更改 以自动执行此行为。

从左侧应用无冲突更改 从右侧应用无冲突更改

从左侧/右侧应用非冲突更改

点击这些按钮以从对话框的左侧/右侧部分合并非冲突更改。

解决简单冲突图标

解决简单的冲突

点击此按钮以解决简单冲突(例如其中一个版本新增了一行)并合并更改。

此类冲突不会通过 应用不冲突的更改 操作解决,因为需要确保它们被正确处理。

使用 GitBlame 注释

该选项仅可通过边距上下文菜单使用。

使用此选项可查看是谁在何时向该文件的存储库版本引入了哪些更改。 注解 视图可让您查看每行代码的详细信息,例如该行源自哪个版本、提交该行的用户 ID 以及提交日期。

有关注释的详细信息,请参见 定位代码作者(使用 Git Blame 注释)

键盘快捷键

键盘快捷键

说明

使用此键盘快捷键可显示最常用差异命令的弹出菜单。

Ctrl+Shift+Tab

使用此键盘快捷键可在左/右窗格之间切换。

Ctrl+ZCtrl+Shift+Z

使用此键盘快捷键可撤消/重做合并操作。 冲突将与文本保持同步。

上下文菜单命令

此上下文菜单在编辑器中央可用:

项目

说明

注释

启用此选项以 注释更改。

显示空格字符

启用此选项后,Diff Viewer 中空格字符将以圆点显示。

显示行号

启用此选项以在 Diff Viewer 中显示行号。

显示缩进指南

启用此选项后,WebStorm 会在 Diff Viewer 中显示垂直线,以指示缩进位置。

使用软换行

启用此选项可在调整对话框大小时,使 WebStorm 自动换行代码行。

高亮级别

使用此菜单项在差异查看器中选择高亮级别。 要了解有关高亮级别的更多信息,请参阅 更改某个文件的高亮显示级别

此上下文菜单在两个编辑器中均可使用:

项目

描述

注解

启用此选项可 注解更改内容。

接受/追加

选择这些命令可 接受或追加 Diff Viewer 中显示的代码行。

与剪贴板比较

选择此命令可将 Diff Viewer 中相应窗格中的文件与 剪贴板的内容进行比较。

切换到三方比较视图

此选项仅在比较两个文件时可用。 该选项允许您加载第三个文件并将其添加到比较中。

此上下文菜单在 Diff Viewer 的右侧面板中可用:

项目

描述

仅跳转到高优先级问题/跳转到下一个问题

单击这些单选按钮之一以定义在发现的问题之间导航的方式。

自定义高亮级别

单击可显示滑块,用于更改 Diff Viewer 中的 高亮级别

在悬停滚动条时显示代码透视

启用后,悬停在滚动条上时可以查看 Diff Viewer 可见区域外的代码。

工作方式

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