Commit & Push

审查完 diff 并对 AI agent 的更改满意后，是时候提交和推送了。本指南引导你完成从暂存到推送到远程仓库的完整工作流。

暂存更改

暂存让你精确选择哪些更改进入本次提交。例如，你可能想要将功能代码与配置更改分开提交。

在 Git 面板中，每个修改的文件都出现在 Unstaged Changes 部分：

• 勾选复选框 暂存单个文件
• 点击 Stage All 一次性暂存所有更改的文件
• 要取消暂存文件，取消勾选 —— 它会移回 Unstaged

已暂存的文件会移动到侧边栏顶部的 Staged Changes 部分。只有已暂存的文件才会包含在提交中。

你也可以暂存单个 hunk（文件的部分）而不是整个文件。在 diff 视图中，悬停在 hunk 上并点击出现的 + 按钮仅暂存该部分。当文件有两个不相关的更改而你只想现在提交其中一个时很有用。

编写提交信息

文件暂存后，在 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

提交

点击消息字段下方的 Commit 按钮。暂存的更改作为新提交保存到你的本地 git 历史中，暂存文件部分会清空。

提交现在出现在你的分支历史中。如果需要撤销，在历史视图中右键点击提交并选择 Undo Commit —— 这会将更改放回未暂存文件而不丢失它们。

推送到远程

提交将更改保存到本地。要将它们发送到 GitHub、GitLab 或其他远程：

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

如果提示输入凭据，你可以输入它们或切换到 SSH 密钥认证。查看 Git Accounts 了解如何连接你的 GitHub 账户以便自动处理凭据。

拉取更改

要从远程引入更改（例如，如果同事推送了内容）：

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

如果有合并冲突，Git 面板会高亮显示冲突的文件。打开每个文件解决冲突，然后暂存并提交解决方案。

推送后，你的更改在远程上，可供你的团队使用或准备拉取请求。Git 面板显示你的分支与远程保持最新。