WebStorm 2025.3 Help

使用差异查看器比较文件和文件夹版本

WebStorm 允许您检查文件/文件夹的两个修订版本之间的差异,或者它们当前的本地副本与版本库版本之间的差异。 差异显示在 差异查看器 中。

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

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

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

    • 右键点击该文件并选择 Git | 显示差异

    • 选择文件并按下 Ctrl+D

    • 双击文件。

  3. 文件的差异视图将打开,其中文件的更改会被高亮显示。

    右窗格包含文件的修改版本。 您可以在差异视图中编辑它。

    左侧窗格包含文件的初始版本。 它是只读的。 您可以点击 还原 (还原) 撤销更改。

    如果您将鼠标悬停在左侧窗格顶部的提交哈希上,会显示一个工具提示,其中包含提交详情,例如提交消息、作者、日期和时间,以及完整的提交哈希。 您可以点击完整的提交哈希,在 日志 选项卡中的 Git 工具窗口 Alt+9 中打开相应的提交。

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

  1. 项目 工具窗口 Alt+1 中选择一个文件或文件夹,然后从上下文菜单中选择 Git | 与修订版本比较

  2. 从打开的对话框中选择一个要与当前文件或文件夹版本进行比较的修订版本。

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

  1. 项目 工具窗口 Alt+1 中选择一个文件或文件夹,然后从上下文菜单中选择 Git | 与分支或标签比较

  2. 在打开的对话框中选择要与当前文件或文件夹版本进行比较的分支或标签。

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

除了在编辑器中 导航查看文件中的本地更改,您还可以查看这些更改与文件基准版本的对比。

要预览差异,请在 提交 工具窗口中选择一个已修改的文件,然后双击它或按 Ctrl+D

左窗格显示基础修订版中的受影响代码,右窗格显示您在本地更改后的受影响代码。

编辑器中的差异预览

请使用工具栏按钮和控件在更改之间导航,并配置 更改详情 窗格或 差异查看器 的外观:

条目

工具提示和快捷键

描述

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

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

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

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

“跳转到源代码”按钮

跳转到源(J)

F4

在编辑器中打开选定的文件。 插入符号将定位在与 差异查看器 中相同的位置。

比较上一个文件图标

比较下一个文件图标

比较前一个/下一个文件

Alt+Left Alt+Right

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

转到已更改的文件图标

转到已更改的文件 Ctrl+N

显示当前更改集中所有已更改的文件,并导航到它们。 此操作仅在您审阅多个文件的更改时可用。

查看者

选择查看器模式:并排或统一。 并排模式包含两个窗格,统一模式包含一个窗格。

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

您只能在并排查看器的右侧部分或统一查看器的下行更改文本。

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

空白

定义差异查看器如何处理空白。

  • 不忽略 :将空白视为重要,并将所有差异高亮显示。 默认选中此选项。

  • 修整空白 :如果空白出现在行尾和行首,则将其修剪(("\t", " "))。

    • 如果两行仅在行尾空白上存在差异,则这两行被视为相同。

    • 如果两行不同,则在 按单词 模式下不高亮显示行尾空白。

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

  • 忽略空格和空行 :忽略空白和空行。 以下内容将被忽略:

    • 所有空白(与 '忽略空白' 选项相同)

    • 所有仅由空格组成的添加或删除的行

    • 所有仅涉及拆分或合并行且不更改非空白部分的更改。

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

高亮模式

选择差异粒度的高亮方式。

可用的选项有:

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

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

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

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

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

  • 不高亮显示 :如果选中此选项,将不会高亮显示任何差异。

    当您处理经过大幅修改的文件时,请使用 不高亮显示 选项。 在此类情况下,高亮显示可能会为审阅带来额外的困难。

折叠未更改的片段图标

收起未更改的片段

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

“同步”按钮

同步滚动

点击此按钮以同时滚动两个差异窗格。 如果取消按下此按钮,每个窗格可以独立滚动。

设置按钮

设置

打开可用设置列表。

这些命令也可以从 差异查看器 栏的上下文菜单中获得。

外部工具图标

在外部工具中显示差异

调用在 外部差异工具设置页面中指定的外部差异查看器。

仅当在 外部差异工具设置页面中启用了 使用外部差异工具 选项时,此按钮才会显示在工具栏上。

帮助图标

帮助

F1

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

使用 GitBlame 注解

此选项仅可从装订区域的上下文菜单中使用。

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

有关注解的更多信息,请参阅 定位代码作者(使用 Git Blame 注释)

最有用的快捷键如下:

快捷方式

描述

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

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