在 GitHub Desktop 中提交并审查对项目的更改

关于提交

类似于保存已经编辑的文件，提交会记录对分支中一个或多个文件的更改。 Git 将为每个提交分配唯一的 ID，称为 SHA 或哈希，用于识别：

在进行提交时，必须包含简要描述更改的提交消息。您也可以在您协作的任何提交上添加一名合作作者。

如果您在 GitHub Desktop 中所做的提交与 GitHub 上的错误帐户相关联，请使用 GitHub Desktop 在 Git 配置中更新电子邮件地址。有关详细信息，请参阅“配置 Git 用于 GitHub Desktop”。

存储库管理员可以为分支启用规则集，以便在提交时强制实施特定约定。例如，规则集可能要求对提交进行签名，或者要求在提交消息的开头引用问题编号。如果提交不遵循规则集，GitHub Desktop 会显示警告并阻止提交。有关详细信息，请参阅“关于规则集”。

您可以更改差异在 GitHub Desktop 中的显示方式，以适应您的审核需求。

要更改您查看差异的方式，请单击差异视图右上角的。

文件的差异视图的屏幕截图。齿轮图标带橙色边框，可展开并显示“空白”和“差异显示”设置。

Tip

用于显示差异的默认选项卡大小为 8。可在“设置”对话框的“外观”窗格中自定义此大小********。

Tip

用于显示差异的默认选项卡大小为 8。可在“选项”对话框的“外观”窗格中自定义此大小********。

如果您需要查看的文件比默认情况下显示的 GitHub Desktop 更多，则可以扩展差异。

在文本编辑器中更改文件并本地保存后，您会在 GitHub Desktop 中看到更改。

在左侧边栏中的“更改”选项卡中：

红色的图标表示删除的文件。
黄色的图标表示经过修改的文件。
绿色的图标表示添加的文件。
要访问暂存的更改，请单击“暂存的更改”。
要将“所有文件中的所有更改”添加到单个提交中，请保留所选列表顶部的复选框处于选中状态。
要将“一个或多个文件中的所有更改”添加到单个提交中，请取消选中不想包含的文件旁边的复选框，只保留要包含在提交中的文件。在选择文件后使用 Spacebar 或 Enter 键可切换复选框状态。

如果一个文件包含多处更改，但只有部分更改要包含在提交中，则可创建部分提交。其余更改会保持不动，以便您进行其他修改和提交。这允许您进行单独、有意义的提交，例如使提交中的换行符更改区别于代码或文字更改。

要从提交中排除更改的行，请单击一条或多条更改的行，以使蓝色消失。仍以蓝色突出显示的行将包含在提交中。

文件的差异视图的屏幕截图。 “不包含此行”行号的背景色为绿色，而非蓝色。

如果您有不想保留的未提交更改，可以放弃这些更改。这将从计算机上的文件中删除更改。您可以放弃一个或多个文件中所有未提交的更改，也可以丢弃添加的特定行。

丢弃的更改保存在回收站中带日期的文件中。在回收站清空之前，您可以恢复丢弃的更改。

您可以丢弃一个或多个未提交的已更改行。

Note

在添加和删除行的一组更改中不可放弃单行。

要放弃一个已添加的行，请在已更改的行列表中，右键单击要放弃的行的行号，然后选择“放弃添加的行”。

文件的差异视图的屏幕截图。在上下文菜单中，光标悬停在“放弃添加的行”上，以蓝色突出显示。

要放弃一组更改的行，请右键单击要放弃的行的行号右侧的垂直条，然后选择“放弃已添加的行”。

文件的差异视图的屏幕截图。在行号的右侧，用橙色轮廓突出显示一条较窄的深蓝色线。

对选择要包含在提交中的更改感到满意后，编写提交消息并推送更改。如果协作处理了某个提交，也可以将提交归于多个作者。

Note

默认情况下，GitHub Desktop 会将您创建的标记推送到含相关提交的仓库。有关详细信息，请参阅“在 GitHub Desktop 中管理标记”。

在更改列表底部的 Summary（摘要）字段中，键入一条简短、有意义的提交消息。您也可以在 Description（说明）字段中添加关于更改的更多信息（可选）。
（可选）要将某个提交归于另一个作者，请单击合作作者图标并输入要包含的用户名。
在“说明”字段下，单击“提交到分支”。
如果您尝试提交的分支受保护，Desktop 将警告您。
- 若要移动更改，请单击“切换分支”。
- 若要将更改提交到受保护的分支，请单击“提交到 BRANCH”。
有关受保护分支的详细信息，请参阅“关于受保护分支”。
若要将本地更改推送到远程存储库，请在存储库栏中单击“推送源”。
如果你有基于所处理的分支的拉取请求，GitHub Desktop 将在存储库栏的“Current Branch”部分旁显示已针对拉取请求运行的检查的状态。有关检查的详细信息，请参阅“在 GitHub Desktop 中查看和重新运行检查”。

如果尚未为当前分支创建拉取请求，则 GitHub Desktop 将提供预览更改和创建请求的选项。有关详细信息，请参阅“从 GitHub Desktop 创建问题或拉取请求”。