WebStorm 2025.2 Help

调查 Git 仓库中的更改

在 WebStorm 中,您可以追溯项目中的所有更改。 这样可帮助您 定位任何更改的作者 、查看 文件版本或提交之间的差异,并在必要时 安全地回滚和撤销更改。

查看项目历史记录

您可以根据指定的筛选器查看项目源代码中的所有更改。 要查看项目历史记录,请打开 日志 选项卡中的 Git 工具窗口 Alt+9。 它显示了提交到所有分支和远程仓库中的所有更改:

Git 日志视图

在多仓库项目中,左侧的彩色条表示所选提交所属的根目录(每个根目录使用不同颜色标记)。 将鼠标悬停在彩色条上可显示提示信息以显示根路径:

根路径
  • 通过输入完整的提交名称、提交消息或其片段、修订号或正则表达式,在提交列表中进行搜索。

  • 按分支或 收藏分支 、用户、日期与文件夹(对于多根项目为根目录和文件夹)筛选提交。

  • 点击工具栏上的 跳转到 Hash/分支/标签 转到 图标或按 Ctrl+F ,然后指定要跳转的提交哈希、 标签 或分支名称(系统将带您跳转到该分支中的最新提交)。

  • LeftRight 键以跳转到父提交或子提交。 当不同仓库和多个分支的提交混合出现在 日志 选项卡中的 Git 工具窗口中 Alt+9 时,此操作尤其有用。

有关 Git 工具窗口 Alt+9日志 选项卡的详细信息,请参阅 日志选项卡

查看特定修订下的项目快照

WebStorm 允许您查看某个选定修订时项目的状态。

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。

  2. 选择一个提交,并从上下文菜单中选择 显示指定版本下的版本库

将打开 版本库 工具窗口,其中包含所选修订时项目的快照。

查看两个提交之间的差异

WebStorm 允许您检查两个提交之间哪些文件被修改,而无需浏览两者之间每个提交的更改。

  • Git 工具窗口 Alt+9日志 选项卡中选择任意两个提交,并从上下文菜单中选择 对比版本

    更改 工具窗口将打开,显示所选提交之间被修改的文件列表。 您可以通过点击 显示差异图标显示差异 或按下 Ctrl+D 来查看任意文件的差异。

查看文件历史记录

您可以查看对某个特定文件所做的全部更改,并找出每个修订中具体修改了哪些内容。

  1. 在任意视图中选择所需文件(包括 项目 工具窗口 Alt+1 、编辑器、 提交 窗口等)。

  2. 从主菜单中选择 Git | 已选择文件 | 显示历史记录 或从所选内容的上下文菜单中选择 Git | 显示历史记录历史记录 选项卡将添加到 Git 工具窗口中,显示所选文件的历史记录,并允许您查看和比较其修订版本。

  3. 要识别某个特定修订版本中引入的更改,请在列表中选择该版本。 在面板右侧立即显示 diff。

  4. 要在专用的 Diff Viewer 中查看整个文件的 diff,请在列表中选择该文件并按 Ctrl+D ,或点击工具栏上的 显示差异图标显示差异Diff Viewer 将打开,并展示该修订版本中的更改内容。

您可以使用工具栏按钮将所选修订版本与本地版本进行比较、比较所选修订版本中的类、签出所选修订版本、注释所选修订版本等操作:

项目

工具提示和快捷键

说明

分支

分支筛选器

单击 分支 并选择一个分支,以查看此分支中对文件所做的更改。

刷新按钮

刷新

单击此按钮以刷新当前信息。

显示差异图标

显示 Diff

Ctrl+D

单击此按钮可在 Diff Viewer 中比较文件所选修订版本与其前一个版本的差异。

显示所有受影响文件按钮

显示所有受影响的文件

Alt+Shift+A

单击此按钮以打开 版本中受影响的路径 对话框,您可以在其中查看所选修订版本中被修改的所有文件。

眼睛图标

视图选项

单击以选择 历史记录 视图中要显示的信息量。 如果希望 WebStorm 显示提交时间戳而非更改作者时间,您也可以选择 显示提交时间戳 选项。

此外,请选择您希望查看的信息类型:

  • 显示详细信息 以显示所选修订版本的提交消息。

  • 显示差异预览 以打开所选修订版本的 diff 预览。

在 GitHub 上打开按钮

在 GitHub 上打开

单击此按钮以在 GitHub 上打开与所选提交对应的页面。

在 GitLab 上打开

单击此按钮以在 GitLab 上打开与所选提交对应的页面。

恢复按钮

启用 Git 日志索引

单击此按钮可改善在整个 IDE 中处理变更历史记录的体验。启用项目仓库索引可实现: 启用项目仓库索引可实现:

  • 快速日志筛选和精确的历史计算。

  • 在文件历史中显示所有分支。

  • 在“Search Everywhere”中跨历史搜索。

若要禁用此选项,请转到 设置 | 版本控制 | 确认 | 日志

重命名

重命名列

单击此列可展开以查看文件重命名的历史记录。将光标悬停在该列上可查看文件路径中的更改。 将光标悬停在该列上可查看文件路径中的更改。

查看所选内容的历史记录

  1. 在编辑器中,选择所需的源代码片段或将插入点放置在相应行。

  2. 从主菜单选择 Git | 当前文件 | 显示所选内容的历史记录 或从所选内容的上下文菜单选择 Git | 显示所选内容的历史记录

所选片段的历史记录将在单独窗口中打开。 如果没有选择任何内容,则会显示当前行的历史记录。

查看目录历史记录

除了查看整个项目或特定文件的历史记录,您还可以检查特定文件夹中的更改内容。

  1. 项目 工具窗口中的 Alt+1 中选择一个或多个目录,然后从上下文菜单中选择 Git | 显示历史记录

  2. 一个新选项卡将添加到 Git 工具窗口的 Alt+9 中,显示根据所选文件夹筛选的提交记录。

查看本地与已提交文件版本间的差异

您可以检查已提交的文件修订与其本地版本的差异:

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。

  2. 选择您感兴趣的提交,并在右侧窗格中选择该文件。

  3. 点击工具栏上的 显示差异图标 按钮。

查看更改的合并方式

WebStorm 允许您查看更改是如何 从一个分支合并到另一个分支 的,以及合并过程中(如有)如何 解决冲突

  • 日志 选项卡(位于 Git 工具窗口 Alt+9 中)中,选择您感兴趣的合并提交。

    • 如果合并过程中未检测到冲突并已解决,WebStorm 会在 已更改的文件 面板中显示对应信息,并建议您查看来自两个父项的更改:

      合并后来自父级的更改

      从某个节点中选择所需文件,点击工具栏上的 显示差异图标显示差异 或按 Ctrl+DDiff Viewer 将显示一个双面板差异视图,允许您比较当前版本与所选父项之间的差异。

    • 如果在合并过程中发生了冲突, 已更改的文件 面板将显示包含冲突的合并文件列表。

      选择所需文件并点击工具栏上的 显示差异图标显示差异 或按 Ctrl+DDiff Viewer 将显示一个三面板差异视图,允许您将当前版本与每个父项进行比较,并查看冲突是如何被解决的。

定位代码作者(使用 Git Blame 注释)

您可以使用 VCS 注释 (对应于 git-blame )功能来查看是谁引入了文件中的哪些更改。 带注释的视图将显示每一行代码的详细信息:

注释

当前修订中修改的行的注释将以粗体和星号标记。

默认情况下,不同的提交将以不同的颜色高亮显示(请参见 配置注释中显示的信息量)。

在注释视图中,您可以跳转至:

  • 日志 工具窗口的 Git 选项卡中的相应提交 Alt+9 :点击注释,或将鼠标悬停于其上,并在详细信息弹窗中点击提交哈希。

  • 行间差异:将鼠标悬停于注释上方。 IDE 将高亮显示来自相关提交的该行内容及其改动。

    在下图中,插入符位于第 24 行,而更改被高亮显示在第 17 行。

    行间差异
  • https://github.com 上的相应提交:使用 在 GitHub 上打开 上下文菜单选项。

  • 如果启用了 问题导航 ,则在您的缺陷跟踪系统中显示相关问题:将鼠标悬停在注解上并单击问题链接(如果其包含在提交消息中)。

启用注释

  • 在编辑器或 Diff Viewer 中右键单击边距,然后在上下文菜单中选择 使用 Git Blame 注释

    您可以为 注释 命令分配自定义快捷键:前往 键位映射 设置页面 Ctrl+Alt+S 并查找 版本控制系统 | Git | 注释

    要关闭注解,请在编辑器或 Diff Viewer 中右键单击边距,并在上下文菜单中选择 关闭注释

配置注释中显示的信息量

您可以选择在注解视图中显示多少信息。

  • 右键单击注解边距,选择 视图 ,然后选择要查看的信息类型,包括此更改来源的版本、日期、作者姓名的不同格式以及提交号。

    您还可以在 颜色 下设置高亮显示。

配置注释选项

  • 右键单击注解边距,在上下文菜单中选择 选项

    • 忽略空白字符 :将忽略空格字符(git blame -w)。 这意味着注解将指向上一个有意义的提交。

    • 检测文件内的移动 :当提交在同一文件中移动或复制代码行时,此类更改将被忽略(git blame -M)。 这意味着注解将指向上一个有意义的提交。

    • 检测跨文件的移动 :当提交从其他在同一次提交中已修改的文件中移动或复制代码行时,此类更改将被忽略(git blame -C)。 这意味着注解将指向上一个有意义的提交。

    • 显示提交时间戳 :如果您希望 WebStorm 在 注释 视图中显示提交时间戳而非更改创建时间,请选择此选项。

自定义日期格式

  1. Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 系统设置 | 日期格式

  2. 单击 日期时间格式 字段右侧的 VCS 注释 ,并指定用于 VCS 注解的日期格式。 请参阅 格式模式参考

在编辑器中显示更改作者

您可以配置编辑器,在 内嵌提示 中显示对元素(方法或类)所做上次更改的作者。 启用方法如下:

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 内联提示 | 代码视觉

  2. 选择 代码作者 选项。

  3. 选择作者姓名显示的位置:

    • 显示在行上方(默认)

    • 显示在右侧

启用此选项后,您可以单击编辑器中的作者名称提示以打开已注解视图。

内嵌提示、代码视觉:代码作者

隐藏更改作者

若要在编辑器中隐藏代码作者姓名,请执行以下任一操作:

  • 打开 编辑器 | 内联提示 | 代码视觉 设置页面 Ctrl+Alt+S ,然后禁用 代码作者 选项。

  • 右键单击编辑器中的作者名称提示并选择 隐藏 `Code Vision: Code author` 内联提示

    隐藏代码作者名称

注释先前的修订版本

WebStorm 不仅允许您注解当前文件版本,也支持注解其之前的版本。 上下文菜单中的注解边距提供以下选项:

  • 标注版本 :如需检查某次更改提交后文件的状态,此选项非常有用。 为此,请右键单击该更改,并在上下文菜单中选择 标注版本

  • 标注上一个版本 :如果某行的最近更改没有实际意义(例如仅更改了格式),此选项非常有用。 此时,您可以查看该文件上一个版本的内容。 为此,请右键单击某个更改,并从上下文菜单中选择 标注上一个版本

  • 隐藏版本 :此选项可帮助避免查看无关或管理性更改。 这些更改通常由底层迁移或格式化操作引入。 当这些更改影响整个根目录时,会在 注释 对话框中产生干扰,因此可将其同时从视图和“注解”列中排除。 隐藏版本 操作允许您就地将某个版本从注解结果中排除,并在编辑器和边距中显示更新后的结果。 可使用相反的操作 恢复隐藏版本 恢复被排除的版本。 隐藏版本的信息会显示在编辑器顶部的通知栏中。 也可以单击通知栏中的相应链接来恢复隐藏版本。

您还可以在 历史记录 视图中注解某个特定文件。 在 历史记录 选项卡中,选择要查看的文件版本,右键单击相应行,然后在上下文菜单中选择 注释

观看此视频,了解如何通过使用注解获益:

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