一、功能简介
工作目录是 Git 仓库时,代码编辑器里自带 Git 面板:看改了哪些文件,暂存、提交、推送、拉取,切换和新建分支,不用开命令行。数字员工改完代码,你在这里看一遍再提交。
常见使用场景:
- 审改动再提交:数字员工改完官网首页,你看过改动后提交并推送。
- 开新分支:做春茶专题前,从 main 新建一个 feature 分支。
- 并行开发:用 worktree 在另一个目录里同时做另一件事,互不影响。
二、操作流程
打开代码编辑器(见代码文件),点左侧侧栏的 Git。任务右侧工作台栏里的「代码工作区」也能看到 变更、当前分支和 提交或推送。
暂存和提交
- 在 未暂存 里看改了哪些文件,点一个文件看具体改动。
- 点文件旁的 暂存,或者点 全部暂存。放错了点 取消暂存。
- 在 提交说明 里写这次改了什么;想让 AI 帮你写,点 AI 生成提交信息。
- 点 提交(
⌘⏎)。想提交后马上推送,在 更多提交操作 里选 提交并推送。
暂存区是空的时候点提交,会问你要不要先 全部暂存。
推送、拉取和获取
点编辑器底部状态栏的同步按钮(与远端同步):
- 获取 Fetch:从远端拿最新提交,不改本地分支。
- 拉取 Pull:拉取并合并到当前分支。
- 推送 Push:把本地提交推到远端。推送后别人就能看到,不能撤回,不会再问你。
推送按钮是灰的时候,鼠标移上去会说明原因,例如「没有可推送的本地提交」「落后上游 N 个提交,请先拉取」。
切换和新建分支
- 点状态栏的分支名(切换分支),打开「分支操作」。
- 切到已有分支:在 切换到分支 里选一个,点 切换。
- 新建分支:在 新分支 里填名字,选 基准分支,点 新建并切换。
有没提交的改动时切换分支,会问你要不要先把改动存起来(stash)再切换。
查看提交历史
点状态栏的 History,打开 Git History,看当前分支最近的提交:说明、作者、时间,点一条看它改了哪些文件。
用 worktree 并行开发
worktree 是同一个仓库在另一个目录里的副本,可以在另一个分支上同时做事。
- 在任务右侧工作台栏的「代码工作区」里,点当前代码目录的名字,打开 worktree 列表。
- 点 新增 worktree,填分支名,点 创建并切换。需要的话点 改位置 自己选目录。
- 想切回来,在列表里点 主目录,或者在另一个 worktree 上点 切换到此处。
切换只影响当前这个任务用的代码目录,文件夹的主目录不变。任务正在运行时不能切换,先停下再切。
三、了解更多
四、常见问题
为什么看不到 Git 面板?
工作目录不是 Git 仓库。可以在终端里进到工作目录,运行 git init 初始化。
AI 生成提交信息提示「需先暂存文件」?
AI 只根据已暂存的改动来写,先暂存再点。
提示「AI 额度不足」?
生成提交信息要用模型,额度用完了。充值或联系管理员以后再试,也可以自己写提交说明。