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

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

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

打开提交工具窗口（Alt+0）。
在更改列表中找到所需文件，然后执行以下任一操作：
- 右键点击该文件并选择 Git | 显示差异。
- 选中文件并按 Ctrl+D。
- 双击该文件。
将打开差异视图，并突出显示对该文件所做的更改。
右侧窗格包含文件的已修改版本。您可以在差异视图中编辑它。
左侧窗格包含文件的初始版本。它为只读。您可以点击（还原）来撤销更改。
如果将鼠标悬停在左侧窗格顶部的提交哈希上，将显示一个工具提示，其中包含提交详细信息，例如提交消息、作者、日期和时间以及完整的提交哈希。您可以点击完整的提交哈希，在 Git 工具窗口 Alt+9 的日志选项卡中打开相应的提交。

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

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

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

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

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

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

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

左侧窗格显示基准修订中的受影响代码，右侧窗格显示您在本地进行更改后的受影响代码。

编辑器中的差异预览

使用工具栏按钮和控件在更改之间导航，并配置更改详细信息窗格或差异查看器的外观：

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

以下是最常用的快捷键：

快捷方式	描述
`Ctrl+Shift+D`	使用此键盘快捷键显示最常用的差异命令的弹出菜单。
`Ctrl+Shift+Tab`	使用此键盘快捷键在左侧和右侧窗格之间切换。
`Ctrl+Z`/`Ctrl+Shift+Z`	使用此键盘快捷键撤销/重做合并操作。冲突将与文本保持同步。

2026年 3月 24日