提交与推送

暂存文件,手动或借助 AI 智能体撰写提交信息,几次点击即可推送到远程仓库。

在你审阅完 diff,并对 AI 智能体所做的修改满意之后,就可以提交并推送了。本指南将带你走完从暂存到推送至远程仓库的完整流程。

暂存更改

暂存可以让你精确选择哪些更改进入本次提交。例如,你可能希望把功能代码和配置变更分开提交。

在 Git 面板中,每个已修改的文件都会显示在 Unstaged Changes(未暂存更改)区域:

  • 勾选文件旁的复选框即可单独暂存该文件
  • 点击 Stage All 一次性暂存所有已更改的文件
  • 要取消暂存某个文件,取消勾选即可——它会回到未暂存区域

已暂存的文件会移到侧边栏顶部的 Staged Changes(已暂存更改)区域。只有已暂存的文件才会包含在提交中。

你也可以只暂存单个 hunk(文件中的某一段更改),而不是整个文件。在 diff 视图中,将鼠标悬停在某个 hunk 上,点击出现的 + 按钮,即可只暂存该部分。当一个文件里有两处互不相关的更改,而你现在只想提交其中一处时,这非常有用。

以文件夹树查看更改

智能体产生的 diff 往往范围广而层级浅——一次更改涉及四个目录、十八个文件是很平常的事。扁平列表会把它变成十八行几乎一模一样的路径。

Filter(筛选)框旁边有一个开关,可以在扁平列表和 VS Code 风格的文件夹树之间切换 Changes 列表,而且你的选择会在下次打开对话框时保留。

文件夹树模式下的 Git Changes 对话框:18 个已更改文件嵌套在 scripts、src/main/database/adapters 和 renderer/components 下,每个目录行都带有按文件夹暂存的复选框

  • 文件夹复选框可一键暂存或取消暂存其下的所有内容,因此按区域审阅和按区域暂存是同一个操作。
  • 文件夹上的短横线表示部分已暂存。 部分暂存很容易不小心产生,在扁平列表中几乎看不出来;三态复选框会在目录层级把它显示出来。
  • 全部折叠 / 全部展开可以应对跨越许多目录的更改集。

扁平列表保持不变,每一行仍显示完整路径,适用于更改集很小、分组反而多余一次点击的情况。

撰写提交信息

文件暂存后,在 Git 面板底部的文本框中输入提交信息。

好的提交信息能让你的历史记录清晰易读——无论对未来的自己,还是对项目中的其他人。几点建议:

  • 使用祈使语气——写 "Add login form",而不是 "Added login form" 或 "Adding login form"
  • 说明改了什么以及为什么——"Fix null check in user.ts" 比 "fix bug" 更有用
  • 第一行控制在 72 个字符以内——大多数 Git 工具在列表视图中会截断更长的信息
  • 需要时添加正文——在第一行之后按两次 Enter,即可在下方添加更详细的说明

清晰的提交信息示例:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

让智能体来写

提交摘要中的闪光按钮会把你的 diff 交给已安装的 AI CLI,并请它生成一条提交信息。

  • 你可以指定由哪个智能体来写,也可以让 1DevTool 使用你安装的第一个智能体。Kimi Code 与其他智能体一同出现在列表中。安装的智能体较多时,菜单会自适应窗口大小并可滚动。
  • 选择风格:Conventional、Plain 或 Gitmoji。
  • 如果还没有暂存任何内容,它会退而使用工作区的 diff——这样你可以在决定暂存什么之前就先得到一条提交信息。

结果会作为普通的可编辑文本出现在信息框中。它只是草稿,而不是一次提交。

提交

点击信息框下方的 Commit 按钮。已暂存的更改会作为一次新提交保存到本地 Git 历史中,已暂存文件区域随之清空。

这次提交现在会出现在你的分支历史中。如果需要撤销,在历史视图中右键点击该提交并选择 Undo Commit——这会把更改放回未暂存的文件中,不会丢失任何内容。

推送到远程

提交只会把更改保存在本地。要把它们发送到 GitHub、GitLab 或其他远程仓库:

  1. 点击 Git 面板工具栏中的 Push 按钮(向上箭头图标)
  2. 如果该分支已存在于远程,你的提交会立即被推送
  3. 如果这是远程上尚不存在的新分支,点击 Publish Branch——这会在远程创建该分支并推送你的提交

如果提示输入凭据,你可以直接输入,也可以改用 SSH 密钥认证。关于如何连接你的 GitHub 账号以便自动处理凭据,请参阅 Git 账户。

推送新分支到远程的 Git 界面

拉取更改

要从远程获取更改(例如队友推送了新内容):

  1. 点击工具栏中的 Pull 按钮(向下箭头图标)
  2. 远程更改会被获取并合并到你的本地分支

如果存在合并冲突,Git 面板会高亮显示有冲突的文件。逐个打开它们解决冲突,然后暂存并提交解决结果。

添加 Git 的快捷按钮

推送之后,你的更改就已在远程,团队成员可以获取,或随时发起拉取请求。Git 面板会显示你的分支与远程保持同步。