调查 Git 仓库中的更改
在 WebStorm 中,您可以追溯项目中的所有更改。 这样可帮助您 定位任何更改的作者 、查看 文件版本或提交之间的差异,并在必要时 安全地回滚和撤销更改。
查看项目历史记录
您可以根据指定的筛选器查看项目源代码中的所有更改。 要查看项目历史记录,请打开 日志 选项卡中的 Git 工具窗口 Alt+9。 它显示了提交到所有分支和远程仓库中的所有更改:

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

浏览并搜索项目历史记录
通过输入完整的提交名称、提交消息或其片段、修订号或正则表达式,在提交列表中进行搜索。
按分支或 收藏分支 、用户、日期与文件夹(对于多根项目为根目录和文件夹)筛选提交。
点击工具栏上的 跳转到 Hash/分支/标签
图标或按 Ctrl+F ,然后指定要跳转的提交哈希、 标签 或分支名称(系统将带您跳转到该分支中的最新提交)。
按 Left 和 Right 键以跳转到父提交或子提交。 当不同仓库和多个分支的提交混合出现在 日志 选项卡中的 Git 工具窗口中 Alt+9 时,此操作尤其有用。
有关 Git 工具窗口 Alt+9 的 日志 选项卡的详细信息,请参阅 日志选项卡。
查看特定修订下的项目快照
WebStorm 允许您查看某个选定修订时项目的状态。
打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。
选择一个提交,并从上下文菜单中选择 显示指定版本下的版本库。
将打开 版本库 工具窗口,其中包含所选修订时项目的快照。
查看两个提交之间的差异
WebStorm 允许您检查两个提交之间哪些文件被修改,而无需浏览两者之间每个提交的更改。
在 Git 工具窗口 Alt+9 的 日志 选项卡中选择任意两个提交,并从上下文菜单中选择 对比版本。
更改 工具窗口将打开,显示所选提交之间被修改的文件列表。 您可以通过点击
显示差异 或按下 Ctrl+D 来查看任意文件的差异。
查看文件历史记录
您可以查看对某个特定文件所做的全部更改,并找出每个修订中具体修改了哪些内容。
在任意视图中选择所需文件(包括 项目 工具窗口 Alt+1 、编辑器、 提交 窗口等)。
从主菜单中选择 Git | 已选择文件 | 显示历史记录 或从所选内容的上下文菜单中选择 Git | 显示历史记录。 历史记录 选项卡将添加到 Git 工具窗口中,显示所选文件的历史记录,并允许您查看和比较其修订版本。
要识别某个特定修订版本中引入的更改,请在列表中选择该版本。 在面板右侧立即显示 diff。
要在专用的 Diff Viewer 中查看整个文件的 diff,请在列表中选择该文件并按 Ctrl+D ,或点击工具栏上的
显示差异。 Diff Viewer 将打开,并展示该修订版本中的更改内容。
您可以使用工具栏按钮将所选修订版本与本地版本进行比较、比较所选修订版本中的类、签出所选修订版本、注释所选修订版本等操作:
项目 | 工具提示和快捷键 | 说明 |
|---|---|---|
分支 | 分支筛选器 | 单击 分支 并选择一个分支,以查看此分支中对文件所做的更改。 |
刷新 | 单击此按钮以刷新当前信息。 | |
显示 Diff Ctrl+D | 单击此按钮可在 Diff Viewer 中比较文件所选修订版本与其前一个版本的差异。 | |
显示所有受影响的文件 Alt+Shift+A | 单击此按钮以打开 版本中受影响的路径 对话框,您可以在其中查看所选修订版本中被修改的所有文件。 | |
视图选项 | 单击以选择 历史记录 视图中要显示的信息量。 如果希望 WebStorm 显示提交时间戳而非更改作者时间,您也可以选择 显示提交时间戳 选项。 此外,请选择您希望查看的信息类型:
| |
在 GitHub 上打开 | 单击此按钮以在 GitHub 上打开与所选提交对应的页面。 | |
在 GitLab 上打开 | 单击此按钮以在 GitLab 上打开与所选提交对应的页面。 | |
启用 Git 日志索引 | 单击此按钮可改善在整个 IDE 中处理变更历史记录的体验。启用项目仓库索引可实现: 启用项目仓库索引可实现:
若要禁用此选项,请转到 。 | |
| 重命名列 | 单击此列可展开以查看文件重命名的历史记录。将光标悬停在该列上可查看文件路径中的更改。 将光标悬停在该列上可查看文件路径中的更改。 |
查看所选内容的历史记录
在编辑器中,选择所需的源代码片段或将插入点放置在相应行。
从主菜单选择 Git | 当前文件 | 显示所选内容的历史记录 或从所选内容的上下文菜单选择 Git | 显示所选内容的历史记录。
所选片段的历史记录将在单独窗口中打开。 如果没有选择任何内容,则会显示当前行的历史记录。
查看目录历史记录
除了查看整个项目或特定文件的历史记录,您还可以检查特定文件夹中的更改内容。
在 项目 工具窗口中的 Alt+1 中选择一个或多个目录,然后从上下文菜单中选择 。
一个新选项卡将添加到 Git 工具窗口的 Alt+9 中,显示根据所选文件夹筛选的提交记录。
查看本地与已提交文件版本间的差异
您可以检查已提交的文件修订与其本地版本的差异:
打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。
选择您感兴趣的提交,并在右侧窗格中选择该文件。
点击工具栏上的
按钮。
查看更改的合并方式
WebStorm 允许您查看更改是如何 从一个分支合并到另一个分支 的,以及合并过程中(如有)如何 解决冲突:
在 日志 选项卡(位于 Git 工具窗口 Alt+9 中)中,选择您感兴趣的合并提交。
如果合并过程中未检测到冲突并已解决,WebStorm 会在 已更改的文件 面板中显示对应信息,并建议您查看来自两个父项的更改:

从某个节点中选择所需文件,点击工具栏上的
显示差异 或按 Ctrl+D。 Diff Viewer 将显示一个双面板差异视图,允许您比较当前版本与所选父项之间的差异。
如果在合并过程中发生了冲突, 已更改的文件 面板将显示包含冲突的合并文件列表。
选择所需文件并点击工具栏上的
显示差异 或按 Ctrl+D。 Diff 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 在 注释 视图中显示提交时间戳而非更改创建时间,请选择此选项。
自定义日期格式
按 Ctrl+Alt+S 打开设置,然后选择 。
单击 日期时间格式 字段右侧的 VCS 注释 ,并指定用于 VCS 注解的日期格式。 请参阅 格式模式参考。
在编辑器中显示更改作者
您可以配置编辑器,在 内嵌提示 中显示对元素(方法或类)所做上次更改的作者。 启用方法如下:
按 Ctrl+Alt+S 打开设置,然后选择 。
选择 代码作者 选项。
选择作者姓名显示的位置:
显示在行上方(默认)
显示在右侧
启用此选项后,您可以单击编辑器中的作者名称提示以打开已注解视图。

隐藏更改作者
若要在编辑器中隐藏代码作者姓名,请执行以下任一操作:
打开 编辑器 | 内联提示 | 代码视觉 设置页面 Ctrl+Alt+S ,然后禁用 代码作者 选项。
右键单击编辑器中的作者名称提示并选择 隐藏 `Code Vision: Code author` 内联提示。

注释先前的修订版本
WebStorm 不仅允许您注解当前文件版本,也支持注解其之前的版本。 上下文菜单中的注解边距提供以下选项:
标注版本 :如需检查某次更改提交后文件的状态,此选项非常有用。 为此,请右键单击该更改,并在上下文菜单中选择 标注版本。
标注上一个版本 :如果某行的最近更改没有实际意义(例如仅更改了格式),此选项非常有用。 此时,您可以查看该文件上一个版本的内容。 为此,请右键单击某个更改,并从上下文菜单中选择 标注上一个版本。
隐藏版本 :此选项可帮助避免查看无关或管理性更改。 这些更改通常由底层迁移或格式化操作引入。 当这些更改影响整个根目录时,会在 注释 对话框中产生干扰,因此可将其同时从视图和“注解”列中排除。 隐藏版本 操作允许您就地将某个版本从注解结果中排除,并在编辑器和边距中显示更新后的结果。 可使用相反的操作 恢复隐藏版本 恢复被排除的版本。 隐藏版本的信息会显示在编辑器顶部的通知栏中。 也可以单击通知栏中的相应链接来恢复隐藏版本。
您还可以在 历史记录 视图中注解某个特定文件。 在 历史记录 选项卡中,选择要查看的文件版本,右键单击相应行,然后在上下文菜单中选择 注释。
观看此视频,了解如何通过使用注解获益: