PyCharm 2025.3 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 ,并比较其他本地修改的文件。 此行为取决于 到达最后一次更改后转到下一个文件 选项,位于 差异查看器设置 中。

转到源按钮

跳转到源(J)

F4

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

比较上一个文件图标

比较下一个文件图标

比较上一个/下一个文件

Alt+Left Alt+Right

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

转到已更改的文件图标

转到已更改的文件 Ctrl+N

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

查看器

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

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

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

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

空白

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

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

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

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

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

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

  • 忽略空格和空行 :忽略空白和空行。 将忽略以下实体:

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

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

    • 所有由拆分或合并行构成、且未更改非空白部分的更改。

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

高亮模式

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

可用选项包括:

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

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

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

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

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

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

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

折叠未更改片段图标

收起未更改的片段

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

同步按钮

同步滚动

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

设置按钮

设置

打开可用设置列表。

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

外部工具图标

在外部工具中显示差异

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

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

帮助图标

帮助

F1

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

使用 GitBlame 注解

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

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

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

以下是最常用的快捷键:

快捷键

说明

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

Ctrl+Shift+Tab

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

Ctrl+Z/Ctrl+Shift+Z

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

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