文件夹差异查看器

当您比较以下对象之间的差异时，将显示此窗口：

通过此对话框，您可以查看差异并在不同文件夹之间同步文件。

图标	工具提示和快捷键	描述	适用于
/	`F7` `Shift+F7`	在上一个差异与下一个差异之间导航。当到达最后一个或第一个差异时， PyCharm 会建议您再次按下 `F7`/`Shift+F7` ，并比较其他文件。仅当从版本控制工具窗口 `Alt+9` 调用差异查看器时，此功能才可用。	版本控制
	跳转到源(J) `F4`	在编辑器的活动选项卡中打开文件。插入符将放置在与差异查看器中相同的位置。	全部
	刷新	刷新差异查看器的内容。	全部
	在左侧显示新文件	在左侧窗格中显示存在于第一个待比较目录或数据库对象中、但在第二个中缺失的项。	全部
	在外部工具中显示差异	调用外部差异查看器。有关外部差异查看器的详细信息，请参阅外部差异工具页面。仅当在外部差异工具设置页面中选择了使用外部差异工具选项时，此按钮才可用。	全部
	显示差异	显示同时存在于两个文件夹或数据库对象中但内容、时间戳或大小不同的项。	全部
	显示相同的文件	显示同时存在于两个目录或对象中且内容、时间戳和大小相同的项，具体取决于比较依据列表中设置的参数。	全部
	在右侧显示新文件	显示存在于第二个待比较目录中、但在第一个中缺失的项。数据库对象同样适用。	全部
	比较依据	应用所选比较参数。您可以在以下参数之间进行选择：二进制内容文本（忽略字符集和行分隔符）大小大小和时间戳	本地文件夹本地-远程文件夹
	同步选定项 `Enter`	将指定的操作应用于所选的一对项。在表格的 * 列中，您可以看到将要执行的操作。	全部
	全部同步 `Ctrl+Enter`	将指定的操作应用于列表中的所有项对。在表格的 * 列中，您可以看到将要执行的操作。	全部
	交换两侧	点击此按钮可在差异查看器中交换两侧。	全部
	隐藏已排除的文件	隐藏已从同步中排除的文件。	本地-远程文件夹
	筛选	在比较的文件夹中筛选对象。您可以键入文件或表名称，并根据该名称筛选所有对象。使用星号通配符（*）替换任意数量的任意字符。请注意，按下 `Enter` 后应用筛选。	全部
	路径	这些字段显示所比较文件夹的路径。要更改目录，请点击浏览按钮（），并指定其他目录。	本地文件夹本地-远程文件夹
	帮助 `F1`	打开浏览器并显示相应的帮助页面。	全部

比较表

该表列出了符合比较依据列表中指定的比较条件以及通过工具栏按钮指定的筛选条件的项。

项目	描述	适用于
名称	该列列出属于路径字段中指定对象的文件名。	全部
大小	该列列出文件大小。	本地文件夹本地-远程文件夹
日期	该列列出文件时间戳。	本地文件夹本地-远程文件夹
*	该列列出将应用于同一行中一对项的操作。：将左侧项复制到右侧。如果目标项已存在，此操作可能会覆盖相应目标项的内容。：将右侧项复制到左侧。如果目标项已存在，此操作可能会覆盖相应目标项的内容。：根据所选比较选项，两个对象中的项被视为相同。不执行任何操作。：根据所选比较选项，这些项不同。不执行任何操作。您可以在差异窗格中查看对象之间的差异，并通过点击其图标更改预期操作。：该项仅存在于其中一个文件夹中，将被删除。此外，您还可以点击同步所选或全部同步工具栏按钮来应用该操作。同步所选按钮仅对所选文件应用操作。全部同步按钮对所有文件应用操作要更改所选操作，请点击 * 列中的操作图标。	全部

差异窗格

仅对具有相同名称且同时存在于两个文件夹中的文件显示差异窗格。如果文件或数据库对象仅存在于一个文件夹中，窗格将显示所选文件的内容。

要在差异查看器的各窗格之间切换，请按 Ctrl+Tab。活动窗格中有插入符。

差异查看器

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

上下文菜单

当您在项目列表中右键点击某个条目时，将显示上下文菜单。此菜单中的命令定义当您点击同步所选或同步全部时，对所选条目应采取的操作。所选操作将显示在 * 列中。

命令	图标	描述
设为复制到右侧/左侧		复制在某个目录中缺失的文件。
设为删除		删除文件。
设为不执行任何操作		移除操作图标。
设为镜像到右侧		当您点击全部同步时，将左侧文件夹的内容镜像到右侧文件夹。
设为镜像到左侧		当您点击全部同步时，将右侧文件夹的内容镜像到左侧文件夹。
设为默认		为该条目设置默认操作。
删除时警告		在合并期间删除仅位于两个目录之一中的文件之前显示警告。

文件比较状态和预期操作显示在带星号（* ）标记的列中。要分配或更改操作，请使用与相应单元格关联的上下文菜单。或者，点击该单元格，或按 Space 一次或多次。

图标	描述
	文件仅存在于左侧文件夹中。将文件复制到右侧文件夹。如果两个文件夹中都存在该文件，并且您应用此操作，则右侧文件夹中的文件将被覆盖。
	对于所选比较条件，文件不相同。不执行任何操作。在视图的下方查看文件差异。您可以通过分配并应用相应的操作来选择覆盖其中一个文件。您也可以修改文件内容。这可以通过键入或使用以下按钮和上下文菜单命令来完成：或或替换。将该片段替换为来自另一窗格的片段。或或插入。将该片段插入到另一窗格中。移除。移除相应片段。要撤消更改，请使用 `Ctrl+Z`。
	对于所选比较条件，文件相同。不执行任何操作。
	文件仅存在于右侧文件夹中。将文件复制到左侧文件夹。如果两个文件夹中都存在该文件，并且您应用此操作，则左侧文件夹中的文件将被覆盖。
	删除该文件。对于同时存在于两个文件夹中的文件，该操作不可用。

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