PyCharm 2026.1 Help

文件差异查看器

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

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

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

比较与合并查看器

项目

工具提示与快捷键

描述

上一个差异按钮/下一处差异按钮

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

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

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

比较上一个文件图标

比较下一个文件图标

比较上一个/下一个文件

Alt+Left Alt+Right

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

转到已更改的文件图标

转到已更改的文件 Ctrl+N

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

转到源按钮

跳转到源(J)

F4

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

查看器

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

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

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

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

空白字符

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

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

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

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

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

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

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

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

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

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

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

高亮显示模式

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

可用选项为:

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

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

  • 高亮显示拆分的更改 :如果选择此选项,将把大的更改拆分为较小的更改。

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

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

  • 不高亮显示 :如果选择此选项,将完全不高亮显示差异。

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

折叠未更改片段图标

收起未更改的片段

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

同步按钮

同步滚动

点击此按钮可同时滚动两个差异窗格。 释放此按钮后,可独立滚动每个窗格。

设置按钮

设置

打开可用设置列表(例如, 使用 Git Blame 注解在单独窗口中显示差异)。

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

“交换两侧”按钮

交换两侧

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

包含到提交中 Alt+I

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

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

帮助图标

帮助

F1

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

Ctrl+Shift+Tab

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

应用左侧 应用右侧

接受

在窗格之间(并排查看器)或行之间(统一查看器)应用差异。

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

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

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

合并操作

“比较内容”图标

比较内容

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

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

应用非冲突更改按钮

应用所有非冲突更改

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

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

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

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

“解决简单冲突”图标

解决简单的冲突

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

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

使用 GitBlame 注解

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

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

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

键盘快捷键

快捷键

描述

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

上下文菜单命令

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

项目

描述

注解

启用此选项以 注解 更改。

显示空白字符

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

显示行号

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

显示缩进参考线

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

使用软换行

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

高亮级别

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

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

项目

描述

注解

启用此选项以 注解 更改。

接受/追加

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

与剪贴板比较

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

切换到三侧查看器

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

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

项目

描述

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

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

自定义高亮级别

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

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

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

工作原理

2026年 3月 24日