使用 Diff 查看器对比文件和文件夹版本

WebStorm 可让您比较文件／文件夹的两个修订版本之间，或其本地副本与版本库版本之间的差异。差异将在差异查看器中显示。

将已修改的文件与其 Git 仓库版本进行对比

打开提交工具窗口 Alt+0。
在变更列表中定位所需文件，然后执行以下操作之一：
- 右键单击文件，然后选择 Git | 显示差异。
- 选择文件并按下 Ctrl+D。
- 双击该文件。
将打开差异视图，文件的更改内容将高亮显示。
右侧窗格显示文件的修改版本。您可以在差异视图中编辑该文件。
左侧窗格显示文件的初始版本。这是只读的。您可以单击（还原）以撤销更改。
将鼠标悬停在左侧窗格顶部的提交哈希上时，将显示包括提交消息、作者、日期和时间以及完整提交哈希等信息的工具提示。您可以单击完整的提交哈希，在日志标签页的 Git 工具窗口中打开相关提交 Alt+9。

将文件或文件夹的当前修订版本与同一 Git 分支中的另一个修订版本进行对比

在项目工具窗口中选择文件或文件夹 Alt+1 ，然后从上下文菜单中选择 Git | 与修订版本比较。
在打开的对话框中选择要用于比较当前文件或文件夹版本的修订版本。

将文件或文件夹的当前修订版本与另一个 Git 分支或标签进行对比

在项目工具窗口中选择文件或文件夹 Alt+1 ，然后从上下文菜单中选择 Git | 与分支或标签比较。
在打开的对话框中选择要用于比较当前文件或文件夹版本的分支或标签。

将本地更改与基准修订版本进行对比

除了可在编辑器中浏览文件中的本地更改之外，您还可以将这些更改与文件的基准修订版本进行比较。

要预览差异，在提交工具窗口中选择一个已修改的文件并双击该文件，或按下 Ctrl+D。

左侧窗格显示该代码在基准修订版本中的样子，右侧页面显示您在本地修改后代码的样子。

使用工具栏按钮和控件在各项更改之间导航，并配置更改详情窗格或差异查看器的显示方式：

项目	工具提示与快捷键	说明
／	上一个差异／下一个差异 `Shift+F7` `F7`	跳转至上一个或下一个差异位置。到达最后一个或第一个差异位置后，WebStorm 建议再次单击箭头按钮或按下 `F7`／ `Shift+F7` ，以便比较其他本地已修改文件。此行为取决于到达最后更改后跳转到下一个文件选项在差异查看器设置中的设置。
	跳转到源(J) `F4`	在编辑器中打开所选文件。插入符号将放置在与差异查看器中相同的位置。
	比较上一个／下一个文件 `Alt+Left` `Alt+Right`	将上一个或下一个文件的本地副本与来自服务器的更新文件进行比较。仅当本地修改的文件超过一个时，才可使用这些控件。
	跳转至已更改文件 `Ctrl+N`	显示当前变更集中的所有更改文件并可跳转至这些文件。仅在查看多个文件的更改时，此操作才可用。
查看器		选择查看器模式：并排显示或统一显示。并排显示模式有两个面板，统一显示模式只有一个面板。您可以在两种查看器中编辑代码并执行接受、追加、还原操作。在并排查看器中只能在右侧部分修改文本，在统一查看器中只能修改较低一行。您只能编辑本地版本的文件。无法编辑状态为只读的文件。
空白字符		定义差异查看器应如何处理空白字符。不忽略：空白字符重要，所有差异都会高亮显示。此选项为默认选中项。修整空白：如果空白字符出现在行首或行尾，则将其裁剪（`("\t", " ")`）。如果两行仅在尾随空白字符方面存在差异，则视为相等。如果两行不同，在按词模式下不会高亮显示行尾空白。忽略空格：空白字符不重要，无论其在源代码中的位置如何。忽略空格和空行：忽略空格和空行。会忽略以下实体：所有空格（与“忽略空格”选项中的处理方式一致）所有仅包含空格的新增或删除的行所有仅拆分或合并行，但未更改非空格部分的修改。例如，在此模式下不会突出显示 `a b c` 与 `a \n b c` 之间的差异。
高亮显示模式		选择差异高亮显示的粒度方式。可用选项如下：高亮显示单词：修改的词被高亮显示高亮显示行：修改的行被高亮显示高亮显示拆分的更改：如果选中此选项，大的更改将被拆分为多个小的更改。例如， `A \n B` 和 `A X \n B X` 将被视为两个更改，而不是一个。高亮显示字符：修改的符号被高亮显示不高亮显示：如果选中此选项，将完全不显示差异的高亮。处理经过大量修改的文件时，请使用不高亮显示选项。在此类情况下，高亮显示可能会给审查带来额外困难。
	收起未更改的片段	折叠两个文件中所有未更改的片段。可在差异与合并设置页面配置无法折叠的未更改行数。要打开差异与合并页面，请按 `Ctrl+Alt+S` 打开设置，并导航至工具 \| 差异与合并。。
	同步滚动	单击此按钮可同时滚动两个差异面板。取消此按钮后，每个面板可以独立滚动。
	设置	打开可用设置列表。这些命令也可通过差异查看器边栏的上下文菜单使用。
	在外部工具中显示差异	调用 External Diff Tools 设置页面中指定的外部差异查看器。只有在 External Diff Tools 设置页面启用使用外部差异工具选项时，此按钮才会显示在工具栏上。
	帮助 `F1`	打开浏览器并显示相应的帮助页面。
	使用 GitBlame 注释	此选项仅可通过边栏的上下文菜单访问。使用此选项可查看谁在何时将哪些更改引入该文件的版本库版本。注解视图允许您查看每一行代码的详细信息，例如该行来源的版本、提交该行的用户 ID 和提交日期。如需了解有关注释的更多信息，请参阅定位代码作者（使用 Git Blame 注释）。

最常用的快捷键如下：

快捷键	说明
`Ctrl+Shift+D`	使用此快捷键可以显示最常用差异命令的弹出菜单。
`Ctrl+Shift+Tab`	使用此快捷键在左右两个面板之间切换。
`Ctrl+Z`/`Ctrl+Shift+Z`	使用此快捷键撤销/重做合并操作。冲突将与文本保持同步。

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