PyCharm 2026.2 Help

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

PyCharm 允许您检查文件或文件夹的两个修订之间，或其当前本地副本与存储库版本之间的差异。 差异显示在 差异查看器 中。

将已修改的文件与其 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

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

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

转到源按钮

跳转到源代码

F4

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

比较上一个文件图标

比较下一个文件图标

比较上一个/下一个文件

Alt+Left Alt+Right

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

并排查看器 / 统一查看器

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

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

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

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

折叠未更改片段图标

收起未更改的片段

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

设置按钮

设置

其中一些命令也可通过差异查看器装订区域的上下文菜单使用。

在并排差异中对齐更改。 ：通过用空白填充差异，使对应行垂直对齐。

同步滚动：同时滚动两个差异窗格。

在编辑器标签页中显示差异 ：将差异查看器显示为编辑器标签页，而不是单独窗口。

在单独窗口中显示差异 ：将差异查看器显示为单独窗口，而不是编辑器标签页。

忽略差异 ：定义差异查看器应如何处理空格。

  • 无 ：空白很重要，所有差异都会高亮显示。 默认选择此选项。

  • 修整空白 ：当空白字符出现在行尾和行首时进行裁剪（("\t", " ")）。

    • 如果两行仅在行尾空白上有所不同，则这两行被视为相同。

    • 如果两行不同，在 By word 模式下不会高亮显示行尾空白。

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

  • 忽略空格和空行 ：忽略空白字符和空行。 以下内容将被忽略：

    • 所有空白字符（与 '忽略空白字符' 选项相同）

    • 所有仅由空白组成的新增或移除的行

    • 所有仅拆分或合并行而未更改非空白部分的更改。

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

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

  • 全字匹配 ：会高亮显示已修改的单词。

  • 行 ：会高亮显示已修改的行。

  • 拆分更改 ：如果选择此选项，将把大的更改拆分为较小的更改。

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

  • 字符 ：会高亮显示已修改的字符。

  • 无 ：如果选择此选项，将完全不高亮显示差异。

    处理修改幅度较大的文件时，请使用 无 选项。 在这种情况下，高亮显示可能会给审阅带来额外困难。

外部工具图标

在外部工具中显示差异

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

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

帮助图标

帮助

F1

在浏览器中打开相应的帮助页面。

使用 GitBlame 注解

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

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

有关注解的详细信息，请参阅 定位代码作者（使用 Git Blame 进行注解）。

以下是最常用的快捷键：

快捷方式

描述

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

2026年 7月 14日
使用 GPG 密钥签署提交调查 Git 存储库中的更改