在 GitHub Desktop 中提交和审查项目更改

关于提交

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

进行提交时，必须包含一个提交消息，简要描述更改。你还可以为任何你协作的提交添加共同作者。

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

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

你可以更改 GitHub Desktop 中差异的显示方式以满足你的审查需求。

要更改查看差异的方式，在差异视图的右上角，单击.

Screenshot of the diff view of a file. A gear icon is outlined in orange and expanded to display "Whitespace" and "Diff display" settings.

提示

用于显示差异的默认制表符大小为 8。你可以在**设置**对话框的**外观**窗格中自定义此设置。

提示

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

如果需要查看比 GitHub Desktop 默认显示的更多文件内容，可以展开差异。

当你对文本编辑器中的文件进行更改并将其本地保存时，你也会在 GitHub Desktop 中看到这些更改。

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

红色图标表示已删除的文件。
黄色图标表示已修改的文件。
绿色图标表示已添加的文件。
要访问暂存的更改，请单击**暂存的更改**。
要将**所有文件中的所有更改**添加到单个提交中，请保持列表顶部的复选框选中。
要将**一个或多个文件中的所有更改**添加到单个提交中，请取消选中您不希望包含的文件旁边的复选框，只保留您希望包含在提交中的文件。选择文件后，可以使用空格键或Enter键切换复选框。

如果一个文件包含多个更改，但您只想将其中一些更改包含在提交中，则可以创建部分提交。您的其余更改将保持不变，以便您可以进行其他修改和提交。这允许您进行单独的有意义的提交，例如将换行符更改保存在与代码或散文更改分开的提交中。

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

Screenshot of the diff view of a file. The background color for the line number of "I don't want to include this line" is green, not blue.

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

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

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

注意

在添加和删除行的更改组中，禁用丢弃单个行。

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

Screenshot of the diff view of a file. In a context menu, a cursor hovers over "Discard Added Line", highlighted in blue.

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

Screenshot of the diff view of a file. To the right of the line numbers, a narrow, darker blue line is highlighted with an orange outline.

一旦您对选择包含在提交中的更改感到满意，请编写提交消息并推送您的更改。如果您已合作提交，您还可以将提交归因于多个作者。

注意

默认情况下，GitHub Desktop 会将您创建的标签与关联的提交一起推送到您的存储库。有关更多信息，请参阅“在 GitHub Desktop 中管理标签”。

在更改列表底部，在“摘要”字段中，键入简短且有意义的提交消息。或者，您可以在“描述”字段中添加有关更改的更多信息。
或者，要将提交归因于其他作者，请单击添加合作者图标并键入您要包含的用户名。
在“描述”字段下，单击**提交到分支**。
如果您尝试提交到的分支受到保护，Desktop 将会发出警告。
- 要移动您的更改，请单击**切换分支**。
- 要将更改提交到受保护的分支，请单击**提交到分支**。
有关受保护分支的更多信息，请参阅“关于受保护分支”。
要将本地更改推送到远程存储库，请在存储库栏中单击**推送 origin**。
如果您有一个基于您正在处理的分支的拉取请求，GitHub Desktop 将在存储库栏的“当前分支”部分旁边显示为拉取请求运行的检查状态。有关检查的更多信息，请参阅“在 GitHub Desktop 中查看和重新运行检查”。

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