PyCharm 2025.3 Help

文件差异查看器

当您比较两个文件或一个文件的两个版本(本地更改,或本地文件与其在远程存储库中的修订之间的更改)时,将显示此差异查看器。 您可以比较任意类型的文件,包括二进制文件和 .jar 文件。 要打开它,请选择两个要比较的文件,或者选择一个文件以比较其版本,然后按 Ctrl+D。 差异查看器将在新选项卡中打开。

差异查看器提供功能强大的编辑器,支持代码补全、实时模板等功能。

您在差异查看器中应用的更改会自动应用到文件。 在使用差异查看器期间以及关闭后,您随时可以查看文件中的更改。

比较与合并查看器

工具提示和快捷键

说明

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

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

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

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

“比较上一个文件”图标

“比较下一个文件”图标

比较上一个/下一个文件

Alt+Left Alt+Right

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

“转到已更改文件”图标

转到已更改文件 Ctrl+N

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

“跳转到源”按钮

跳转到源(J)

F4

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

查看器

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

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

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

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

空白

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

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

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

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

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

  • 忽略空格 :空白不重要,不考虑其在源代码中的位置。

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

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

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

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

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

高亮显示模式

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

可用选项如下:

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

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

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

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

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

  • 不高亮显示 :选中此选项时,将完全不高亮显示差异。

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

“折叠未更改片段”图标

收起未更改的片段

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

“同步”按钮

同步滚动

点击此按钮可同时滚动两个差异窗格。 松开此按钮后,各窗格可独立滚动。

“设置”按钮

设置

打开可用设置列表。

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

“交换两侧”按钮

交换两侧

点击此按钮在差异查看器中交换两侧。 当您比较两个文件、将文件与剪贴板内容进行比较,或打开空白差异查看器并粘贴要比较的内容时,此操作可用。 要了解详细信息,请参阅 比较文件、文件夹和文本源

包含到提交中 Alt+I

仅当您在具有多个已更改文件(且全部取消选择)的 提交更改对话框 中调用 差异查看器 ,并在浏览它们之间的差异时到达某个文件中的最后一个差异时,才会显示此复选框。

如果希望将已审阅的文件包含到提交中,请选中此复选框。

“帮助”图标

帮助

F1

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

Ctrl+Shift+Tab

在差异查看器的各窗格之间切换。 活动窗格包含插入符号。

应用左侧 应用右侧

接受

在并排查看器中在各窗格之间应用差异,或在统一查看器中在各行之间应用差异。

山形按钮可以更改其行为:

  • 点击 应用左侧应用右侧 以应用更改。 此行为是默认的。

  • 按下 Ctrl 可将 应用左侧应用右侧 更改为 右下角山形按钮左下角山形按钮 ,并追加更改。

合并操作

“比较内容”图标

比较内容

点击此图标以调用选项列表,使您能够比较文件的不同版本以解决冲突。

请注意, 基线 指的是本地版本和存储库版本的来源文件版本(最初显示在中间窗格),而 中间 指的是结果版本。

“应用非冲突更改”按钮

应用所有非冲突更改

点击此按钮可应用所有非冲突更改。 您还可以在“设置”对话框的“比较与合并”页面中选中复选框 自动应用无冲突的更改 ,以使此行为自动执行。

从左侧应用非冲突更改 从右侧应用非冲突更改

从左/右侧应用非冲突更改

点击这些按钮可合并来自对话框左/右侧的非冲突更改。

“解决简单冲突”图标

解决简单的冲突

点击此按钮可解决简单冲突(例如,同一行的开头和结尾在不同的文件修订中被修改),并合并更改。

此类冲突不会通过 应用不冲突的更改 操作解决,因为您必须确保它们得到正确解决。

使用 GitBlame 注解

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

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

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

键盘快捷键

键盘快捷键

说明

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

上下文菜单命令

此上下文菜单在编辑器中部可用:

说明

注解

启用此选项以 注解 更改。

显示空白

启用此选项以在差异查看器中以点的形式显示空白字符。

显示行号

启用此选项以在差异查看器中显示行号。

显示缩进参考线

启用此选项后,PyCharm 将在差异查看器中显示竖线,以指示缩进位置。

使用软换行

启用此选项后,在调整对话框大小时,PyCharm 将对代码行进行换行。

高亮级别

使用此菜单项选择差异查看器中的高亮级别。 有关高亮级别的更多信息,请参阅 更改文件的高亮级别

此上下文菜单在两个编辑器中均可用:

说明

注解

启用此选项以 注解 更改。

接受/追加

选择这些命令以 接受或追加 差异查看器中显示的行。

与剪贴板比较

选择此命令以将差异查看器相应窗格中的文件与 剪贴板的内容 进行比较。

切换到三侧查看器

此选项仅在您将两个文件相互比较时可用。 它允许您加载第三个文件并将其添加到比较中。

此上下文菜单在差异查看器的右侧面板中可用:

说明

仅转到高优先级问题/转到下一个问题

点击其中一个单选按钮,以定义在遇到的问题之间的导航方式。

自定义高亮级别

点击以显示滑块,以更改差异查看器中的 高亮级别

在滚动条悬停时显示代码透镜

启用后,当将鼠标悬停在滚动条上时,可查看差异查看器可见区域之外的代码。

工作原理

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