变更提交对话框

使用此对话框将本地更改提交（签入）到仓库，并可选地创建一个补丁文件。

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

已修改文件窗格

本节列出了自上次提交以来已修改的所有文件。取消当前提交中您想排除的文件旁边的复选框。

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

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

提交消息窗格

在该区域中输入当前提交的注释。您必须在提交消息字段中输入一些描述，才能提交您的更改。

此注释还将用作补丁文件的名称，如果您决定创建补丁。

您可以点击提交消息历史 Ctrl+M 从最近的提交消息列表中选择。

VCS 专用控件

此部分中的控件位于对话框的右上角，并包含适用于您使用的版本控制系统的选项。

项目	描述
Author	使用此列表选择您将要提交更改的作者。当您提交由他人做出的更改时，这可能会很有用。
修改提交	选中此复选框以使用当前更改替换之前的提交。如需更多信息，请参阅 Git Basics: Undoing Things。
签署提交	选择此项，如果您希望签署提交以证明您即将登记的更改是由您完成的，或者您对所提交的代码承担责任。启用此选项时，以下行会自动添加到提交消息的末尾：签署者：<用户名>

项目

描述

Author

使用此列表选择您将要提交更改的作者。当您提交由他人做出的更改时，这可能会很有用。

修改提交

选中此复选框以使用当前更改替换之前的提交。如需更多信息，请参阅 Git Basics: Undoing Things。

签署提交

选择此项，如果您希望签署提交以证明您即将登记的更改是由您完成的，或者您对所提交的代码承担责任。

启用此选项时，以下行会自动添加到提交消息的末尾：签署者：<用户名>

项目	描述
修改提交	选中此复选框以使用当前更改替换之前的提交。如需更多信息，请参阅 Git Basics: Undoing Things。

项目	描述
保持文件锁定	请选择此复选框以在文件签入后保持更改的文件 locked。

项目	描述
作业	只有当您在 Perforce 设置页面上选择启用 Perforce 作业支持复选框时，此区域才可用。请使用此区域中的控件来搜索 Perforce jobs 、将作业链接到选定的更改列表以及分离当前链接的作业。取消链接选定的作业：点击此按钮即可将选定的任务从变更列表中分离。编辑相关任务：点击此按钮以打开编辑链接到变更列表的作业对话框，您可以在其中搜索可用的作业、查看其详细信息，并将作业链接到所选的变更列表。查找并链接匹配该模式的作业：点击此按钮开始快速搜索与字段中指定模式匹配的作业，并将作业附加到更改列表。在该字段中，指定作业的确切名称或根据 Perforce jobs 语法规则的搜索模式。如果只找到一个符合模式的作业，它将自动附加到更改列表。否则，若要在多个可用 job 中选择一个，请点击按钮，并使用编辑与变更列表关联的作业对话框找到所需的 job。区域底部的列表显示当前附加到所选变更列表的作业。

项目

描述

作业

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

请使用此区域中的控件来搜索 Perforce jobs 、将作业链接到选定的更改列表以及分离当前链接的作业。

取消链接选定的作业：点击此按钮即可将选定的任务从变更列表中分离。
编辑相关任务：点击此按钮以打开编辑链接到变更列表的作业对话框，您可以在其中搜索可用的作业、查看其详细信息，并将作业链接到所选的变更列表。
查找并链接匹配该模式的作业：点击此按钮开始快速搜索与字段中指定模式匹配的作业，并将作业附加到更改列表。
在该字段中，指定作业的确切名称或根据 Perforce jobs 语法规则的搜索模式。
如果只找到一个符合模式的作业，它将自动附加到更改列表。否则，若要在多个可用 job 中选择一个，请点击按钮，并使用编辑与变更列表关联的作业对话框找到所需的 job。

区域底部的列表显示当前附加到所选变更列表的作业。

提交检查

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

这些控件适用于以下版本控制系统：

Git
Subversion
Perforce

项目	描述
重新设置代码格式	根据项目代码风格设置进行代码格式化。
重新排列代码	根据 arrangement rules preferences重新排列您的代码。
优化导入	移除冗余的import语句。
清理	自动将当前检查配置文件应用于您将要提交/搁置的文件。
检查恶意依赖项	搜索项目中可能声明的恶意 Composer 和 npm、pnpm 或 Yarn 依赖项。

高级提交检查

请使用此区域的控件以定义在提交所选文件后，您希望 PhpStorm 执行哪些其他操作。

项目	描述
分析代码	在提交时分析修改的文件。点击配置选择一个检查配置文件，IDE将从中运行检查。
检查 TODO (<过滤器名称>)	请检查与指定筛选条件匹配的 TODO 项目。点击配置以选择一个现有的 TODO 过滤器或打开 TODO 设置页面并定义要应用的新过滤器。
运行工具	从此列表中选择您希望 PhpStorm 在所选更改提交后启动的 external tool。您可以从列表中选择一个工具，或点击浏览按钮并在打开的外部工具对话框中配置一个外部工具。
在提交完成后运行高级检查	启用高级检查以在提交更改后运行。即使某些检查失败，您的更改仍会被提交。

差异窗格

要打开差异窗格，请按 Ctrl+D 或者右键点击您想要检查的文件，然后在上下文菜单中选择显示差异。

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

差异窗格工具栏

项目	工具提示和快捷键	描述
/	上一个差异/下一个差异 `Shift+F7` `F7`	跳转到下一个或上一个差异。当到达最后一个或第一个差异时，PhpStorm 建议点击箭头按钮或再次按 `F7`/`Shift+F7` 并比较其他本地修改的文件。该行为依赖于 Go to the next file after reaching last change选项中的差异查看器 settings。
	跳转到源(J) `F4`	在编辑器中打开选定的文件。文本光标的位置与差异查看器相同。
	比较前一个/下一个文件 `Alt+Left` `Alt+Right`	点击这些按钮，将本地副本的前一个/下一个文件与来自服务器的更新进行比较。这些按钮仅在所选变更列表中有多个文件时可用。
查看者		选择查看模式：并排或统一。并排模式有两个面板，而统一模式只有一个面板。您可以在两个查看器中编辑代码并执行接受、追加、还原操作。您只能在并排查看器的右侧部分或统一查看器的下行更改文本。您只能编辑文件的本地版本。您不能编辑只读状态的文件。
空白		定义差异查看器应如何处理空白字符。不忽略：空格很重要，所有的差异都会被突出显示。此选项默认情况下会被选中。修整空白：如果行首或行尾出现空白字符，则删除这些空白字符（`("\t", " ")`）。如果两行仅在尾随空格上有所不同，这些行将被视为相等。如果两行不同，则在 By word模式下，尾随空格不会被高亮显示。忽略空格：空白字符并不重要，不论在源代码中的位置。忽略空格和空行：忽略空格和空行。以下实体被忽略：所有空白字符（如“忽略空白字符”选项中）所有仅由空格组成的添加或删除的行所有仅涉及拆分或合并行且不更改非空白部分的更改。例如，在此模式下不会突出显示 `a b c` 和 `a \n b c` 之间的差异。忽略导入和格式：导入语句和空白处的更改会被忽略（但字符串字面值中的空白处会被保留）。
高亮模式		选择差异粒度突出显示的方式。可用选项包括：高亮显示单词：修改的词汇已高亮显示高亮显示行：已修改的行已高亮显示高亮显示拆分的更改：如果选择此选项，大的更改将被分解为较小的更改。例如， `A \n B` 和 `A X \n B X` 会被视为两个更改，而不是一个。高亮显示字符：修改后的符号已高亮显示不高亮显示：如果选择此选项，将不突出显示差异。当您处理显著修改过的文件时，请使用不高亮显示选项。在这种情况下，高亮显示可能会在审核期间引入额外的困难。
	收起未更改的片段	收起两个文件中所有未更改的片段。不可折叠的未更改行的数量可以在差异与合并设置页面中配置。要打开差异与合并页面，请按 `Ctrl+Alt+S` 进入设置，然后导航至工具 \| Diff & Merge。。
	同步滚动	同时滚动两个差异窗格。如果此按钮被释放，每个窗格都可以独立滚动。
	禁用编辑	启用所选文件本地副本的编辑功能，此功能默认情况下是禁用的。启用编辑时，您可以在提交修改文件之前进行最后的更改。
	编辑器设置	打开可用选项列表。选择或清除这些选项以显示或隐藏行号、缩进指南、空白字符和软换行。
	Help `F1`	打开浏览器并显示相应的帮助页面。