PyCharm 2025.1 Help

文件差异查看器

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

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

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

差异与合并查看器

项目

工具提示和快捷键

描述

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

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

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

当到达最后一个或第一个差异时,PyCharm 建议点击箭头按钮或再次按 F7/Shift+F7 并比较其他本地修改的文件。 该行为依赖于 Go to the next file after reaching last change选项中的 差异查看器 settings

“比较前一个文件”图标

“下一个文件比较”图标

比较前一个/下一个文件

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 进入设置,然后导航至 工具 | Diff & Merge。 .

“同步”按钮

同步滚动

点击此按钮同时滚动两个差异窗格。 如果该按钮被释放,每个窗格可以独立滚动。

设置按钮

设置

打开可用设置列表。

这些命令也可以从 差异查看器 栏的上下文菜单中找到。

交换边按钮

交换两侧

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

包含到提交中 Alt+I

仅当您从 提交更改对话框调用 差异查看器 时,才会出现此复选框,且在有多个已更改文件(全部未选中)的情况下,您在文件中查看其差异并点击最后一个差异。

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

帮助图标

帮助

F1

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

Ctrl+Shift+Tab

在 差异查看器 的窗格之间切换。 活动窗格有文本光标。

向左应用 应用向右

接受

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

箭头按钮可以改变其行为:

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

  • Ctrl 以更改 向左应用应用向右右下角的 chevron 按钮底部左侧的 Chevron 按钮 并附加更改。

合并操作

Compare Contents 图标

比较内容

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

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

“应用不冲突更改”按钮

应用所有不冲突的变更

点击此按钮以应用所有非冲突更改。 您还可以通过在设置对话框的差异与合并页面中选中 自动应用不冲突的变更 复选框,使此行为自动化。

从左侧应用不冲突的变更 从右侧应用不冲突的变更

从左侧/右侧应用不冲突的更改

点击这些按钮以合并对话框左侧/右侧部分中无冲突的更改。

解决简单冲突图标

解决简单的冲突

点击此按钮可解决简单的冲突(例如,如果相同行的起始和结束部分在不同的文件修订版中已被修改)并合并更改。

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

使用 GitBlame 注释

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

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

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

键盘快捷键

键盘快捷键

描述

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

上下文菜单命令

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

项目

描述

注释

启用此选项以 注释更改。

显示空格

启用此选项以在差异查看器中将空格显示为点。

显示行号

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

显示缩进参考线

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

使用软换行

启用此选项以便在调整对话框大小时让 PyCharm 换行代码行。

高亮显示级别

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

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

项目

描述

注释

启用此选项以 注释更改。

接受/附加

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

与剪贴板比较

选择此命令以将文件与 Diff Viewer 相应窗格中的 剪贴板内容进行比较。

切换到三边查看器

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

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

项目

描述

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

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

自定义高亮显示级别

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

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

启用悬停在滚动条上时查看 差异查看器 可见区域外的代码。

最后修改日期: 2025年 4月 23日
OSZAR »