提交与推送
暂存文件,手动或借助 AI 智能体撰写提交信息,几次点击即可推送到远程仓库。
在你审阅完 diff,并对 AI 智能体所做的修改满意之后,就可以提交并推送了。本指南将带你走完从暂存到推送至远程仓库的完整流程。
暂存更改
暂存可以让你精确选择哪些更改进入本次提交。例如,你可能希望把功能代码和配置变更分开提交。
在 Git 面板中,每个已修改的文件都会显示在 Unstaged Changes(未暂存更改)区域:
- 勾选文件旁的复选框即可单独暂存该文件
- 点击 Stage All 一次性暂存所有已更改的文件
- 要取消暂存某个文件,取消勾选即可——它会回到未暂存区域
已暂存的文件会移到侧边栏顶部的 Staged Changes(已暂存更改)区域。只有已暂存的文件才会包含在提交中。
你也可以只暂存单个 hunk(文件中的某一段更改),而不是整个文件。在 diff 视图中,将鼠标悬停在某个 hunk 上,点击出现的 + 按钮,即可只暂存该部分。当一个文件里有两处互不相关的更改,而你现在只想提交其中一处时,这非常有用。
以文件夹树查看更改
智能体产生的 diff 往往范围广而层级浅——一次更改涉及四个目录、十八个文件是很平常的事。扁平列表会把它变成十八行几乎一模一样的路径。
Filter(筛选)框旁边有一个开关,可以在扁平列表和 VS Code 风格的文件夹树之间切换 Changes 列表,而且你的选择会在下次打开对话框时保留。

- 文件夹复选框可一键暂存或取消暂存其下的所有内容,因此按区域审阅和按区域暂存是同一个操作。
- 文件夹上的短横线表示部分已暂存。 部分暂存很容易不小心产生,在扁平列表中几乎看不出来;三态复选框会在目录层级把它显示出来。
- 全部折叠 / 全部展开可以应对跨越许多目录的更改集。
扁平列表保持不变,每一行仍显示完整路径,适用于更改集很小、分组反而多余一次点击的情况。
撰写提交信息
文件暂存后,在 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 formFix crash when user list is emptyUpdate API base URL for production
让智能体来写
提交摘要中的闪光按钮会把你的 diff 交给已安装的 AI CLI,并请它生成一条提交信息。
- 你可以指定由哪个智能体来写,也可以让 1DevTool 使用你安装的第一个智能体。Kimi Code 与其他智能体一同出现在列表中。安装的智能体较多时,菜单会自适应窗口大小并可滚动。
- 选择风格:Conventional、Plain 或 Gitmoji。
- 如果还没有暂存任何内容,它会退而使用工作区的 diff——这样你可以在决定暂存什么之前就先得到一条提交信息。
结果会作为普通的可编辑文本出现在信息框中。它只是草稿,而不是一次提交。
提交
点击信息框下方的 Commit 按钮。已暂存的更改会作为一次新提交保存到本地 Git 历史中,已暂存文件区域随之清空。
这次提交现在会出现在你的分支历史中。如果需要撤销,在历史视图中右键点击该提交并选择 Undo Commit——这会把更改放回未暂存的文件中,不会丢失任何内容。
推送到远程
提交只会把更改保存在本地。要把它们发送到 GitHub、GitLab 或其他远程仓库:
- 点击 Git 面板工具栏中的 Push 按钮(向上箭头图标)
- 如果该分支已存在于远程,你的提交会立即被推送
- 如果这是远程上尚不存在的新分支,点击 Publish Branch——这会在远程创建该分支并推送你的提交
如果提示输入凭据,你可以直接输入,也可以改用 SSH 密钥认证。关于如何连接你的 GitHub 账号以便自动处理凭据,请参阅 Git 账户。

拉取更改
要从远程获取更改(例如队友推送了新内容):
- 点击工具栏中的 Pull 按钮(向下箭头图标)
- 远程更改会被获取并合并到你的本地分支
如果存在合并冲突,Git 面板会高亮显示有冲突的文件。逐个打开它们解决冲突,然后暂存并提交解决结果。

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