提交变更对话框

使用此对话框将本地更改提交（登记）到版本库中，并可选择创建补丁文件。

此对话框中可用的选项取决于您正在使用的版本控制系统。

已修改文件窗格

此部分列出了自上次提交以来已修改的所有文件。取消选中想要从本次提交中排除的文件旁边的复选框。

项目	工具提示与快捷键	描述
	显示差异 `Ctrl+D`	打开差异对话框，突出显示所选文件的本地工作副本与版本库版本之间的差异。
	还原	还原所选文件本地工作副本中所做的所有更改。
	刷新更改 `Ctrl+F5`	点击此按钮可重新加载已更改的文件树视图，以保持最新状态。
	分组依据	选择如何对已修改的文件进行分组 —— 按目录或按模块
	展开或折叠所有节点 `Ctrl+NumPad +` `Ctrl+NumPad -`	点击这些按钮可展开或折叠目录树中的所有节点。此功能在扁平视图中不可用。
变更列表	不适用	从此列表中选择包含所要登记或包含在补丁中的已修改文件的变更列表。默认选中活动变更列表。

已修改文件窗格下方的摘要显示当前选中变更列表的统计信息，例如已修改、新增、已删除和未添加到版本控制的文件数。此区域还显示每种类型的文件数量，以及将要提交的数量。

提交消息窗格

在此区域为当前提交输入注释。在提交信息字段中输入说明后，才能提交更改。

如果选择创建补丁，则此注释也会被用作补丁文件名。

您可以点击提交信息历史记录 Ctrl+M 以从最近的提交信息列表中进行选择。

特定于 VCS 的控件

此部分中的控件位于对话框右上角，包含与所用版本控制系统相关的选项。

项目	描述
作者	使用此列表选择要提交其更改的作者。提交他人所作更改时，此功能可能会很有用。
修补提交	选中此复选框以使用当前更改替换上一次提交。如需详细信息，请参阅 Git 基础：撤销操作。
签署提交	选中此项以签署提交，证明所提交的更改由您本人完成，或者您愿意为所提交的代码承担责任。启用此选项后，将在提交信息末尾自动添加如下行： Signed off by: <username>

项目

描述

作者

使用此列表选择要提交其更改的作者。提交他人所作更改时，此功能可能会很有用。

修补提交

选中此复选框以使用当前更改替换上一次提交。如需详细信息，请参阅 Git 基础：撤销操作。

签署提交

选中此项以签署提交，证明所提交的更改由您本人完成，或者您愿意为所提交的代码承担责任。

启用此选项后，将在提交信息末尾自动添加如下行： Signed off by: <username>

项目	描述
修补提交	选中此复选框以使用当前更改替换上一次提交。如需详细信息，请参阅 Git 基础：撤销操作。

项目	描述
保持文件锁定	选中此复选框，可在提交后保持更改的文件锁定。

项目	描述
任务	仅当您在 Perforce 设置页面中选中启用 Perforce 作业支持复选框时，此区域才可用。使用此区域中的控件搜索 Perforce 任务、将任务关联到所选变更列表以及取消当前关联的任务。取消关联所选作业：点击此按钮可将所选任务从变更列表中移除。编辑关联作业：点击此按钮打开编辑关联到变更列表的任务对话框，在其中搜索可用任务、查看其详细信息，并将任务关联到所选变更列表。查找并关联匹配模式的工作：点击此按钮按字段中指定的模式快速搜索匹配的任务并将其附加到变更列表。在此字段中，依据 Perforce 任务语法规则指定任务的精确名称或搜索模式。如果仅找到一个与模式匹配的任务，则自动将其附加到变更列表。否则，如需在多个可用任务中选择一个，请点击按钮，并使用编辑关联到变更列表的任务对话框查找所需任务。此区域底部的列表显示当前附加到所选变更列表的任务。

项目

描述

任务

仅当您在 Perforce 设置页面中选中启用 Perforce 作业支持复选框时，此区域才可用。

使用此区域中的控件搜索 Perforce 任务、将任务关联到所选变更列表以及取消当前关联的任务。

取消关联所选作业：点击此按钮可将所选任务从变更列表中移除。
编辑关联作业：点击此按钮打开编辑关联到变更列表的任务对话框，在其中搜索可用任务、查看其详细信息，并将任务关联到所选变更列表。
查找并关联匹配模式的工作：点击此按钮按字段中指定的模式快速搜索匹配的任务并将其附加到变更列表。
在此字段中，依据 Perforce 任务语法规则指定任务的精确名称或搜索模式。
如果仅找到一个与模式匹配的任务，则自动将其附加到变更列表。否则，如需在多个可用任务中选择一个，请点击按钮，并使用编辑关联到变更列表的任务对话框查找所需任务。

此区域底部的列表显示当前附加到所选变更列表的任务。

提交前检查

使用此区域中的控件定义在提交所选文件时您希望 WebStorm 执行的其他操作。

以下版本控制系统支持这些控件：

Git
Subversion
Perforce

项目	描述
重新格式化代码	根据项目代码样式设置执行代码格式化。
重新排列代码	根据排列规则首选项重新排列您的代码。
优化导入	删除多余的 import 语句。
清理	自动将当前检查配置文件应用于您要提交／搁置的文件。

高级提交检查

使用此区域中的控件定义在提交所选文件后您希望 WebStorm 执行的其他操作。

项目	描述
分析代码	在提交过程中分析已修改的文件。点击配置以选择 IDE 将从中运行检查的检查配置文件。
检查 TODO（<filter name>）	审阅与指定过滤器匹配的 TODO 项。点击配置以选择现有的 TODO 过滤器或打开 TODO 设置页面定义要应用的新过滤器。
运行工具	在此列表中选择您希望 WebStorm 在提交所选更改后启动的外部工具。您可以从列表中选择工具，也可以点击浏览按钮，然后在打开的外部工具对话框中配置外部工具。
在提交完成后运行高级检查	启用提交更改后运行的高级检查。即使某些检查未通过，您的更改仍会被提交。即使某些检查未通过，您的更改仍会被提交。

差异窗格

要打开 Diff 窗格，请按 Ctrl+D ，或右键单击您想要查看的文件，并在上下文菜单中选择显示 Diff。

在此窗格中，您可以查看所选文件的基础仓库版本与即将提交版本之间的差异。

差异窗格工具栏

项目	工具提示与快捷键	描述
/	上一个差异／下一个差异 `Shift+F7` `F7`	跳转至上一个或下一个差异。当到达第一个或最后一个差异时，WebStorm 会建议再次点击箭头按钮或按 `F7`／ `Shift+F7` ，以比较其他本地修改的文件。此行为取决于到达最后一个更改后转到下一个文件选项，该选项位于 Diff Viewer 设置中。
	跳转到源(J) `F4`	在编辑器中打开所选文件。插入符将定位于与 Diff 查看器中相同的位置。
	比较上一个／下一个文件 `Alt+Left` `Alt+Right`	点击这些按钮可比较前一个／下一个文件的本地副本与其来自服务器的更新。仅当所选变更列表中包含多个文件时，这些按钮才可用。
查看器		选择查看器模式：并排或统一。并排模式有两个面板，而统一模式只有一个面板。您可以在两个查看器中编辑代码并执行接受、追加、还原操作。您只能在并排查看器的右侧部分或统一查看器的下方行中修改文本。您只能编辑文件的本地版本。无法编辑只读状态的文件。
空白符		定义 Diff Viewer 应如何处理空白符。不忽略：空格很重要，所有差异都会被突出显示。该选项为默认选中。修整空白：如果空格出现在行首或行尾，将对其进行裁剪（`("\t", " ")`）。如果两行之间仅在尾部空格上存在差异，则视为相同。如果两行存在差异，则在按单词模式下不会突出显示尾部空格。忽略空格：空格不重要，无论其在源代码中的位置如何。忽略空格和空行：忽略空格和空行。将忽略以下实体：所有空格（如“忽略空格”选项中）。所有仅包含空格的新增或删除行所有仅对非空格部分无改动的拆分或合并行的更改。例如，在此模式下， `a b c` 与 `a \n b c` 之间的差异不会被突出显示。
突出显示模式		选择差异粒度的突出显示方式。可用选项有：高亮显示单词：被修改的单词将被突出显示高亮显示行：被修改的行将被突出显示高亮显示拆分的更改：选中该选项后，大的更改将被拆分为多个小更改。例如， `A \n B` 和 `A X \n B X` 将被视为两个更改，而不是一个。高亮显示字符：被修改的符号将被突出显示不高亮显示：选中该选项后，不会突出显示任何差异。在处理发生重大修改的文件时，请使用不高亮显示选项。在这种情况下，突出显示可能会在审查过程中带来额外困难。
	收起未更改的片段	折叠两个文件中所有未更改的片段。不可折叠的未更改行数可在差异与合并设置页面中进行配置。要打开差异与合并页面，请按 `Ctrl+Alt+S` 访问设置并导航到工具 \| Diff 与合并。。
	同步滚动	同时滚动两个差异窗格。取消本按钮后，每个窗格将可独立滚动。
	禁用编辑	启用对所选文件本地副本的编辑，默认情况下为禁用。启用编辑后，您可以在提交前对已修改的文件进行临时更改。
	编辑器设置	打开可用选项列表。选中或取消这些选项以显示或隐藏行号、缩进指南、空格和软换行。
	帮助 `F1`	打开浏览器并显示相应的帮助页面。