任务进阶
不用打开终端,在 Caravel 里查看改动、提交、推送、切换分支、查看历史和储藏改动。每个按钮旁都标注了对应的 Git 命令。
打开 Git 菜单
点击任务标题下方显示分支名的按钮(例如 main +2),会弹出 Git 菜单。在任务库、编辑器和 关联工作区 的卡片上,也有同样的分支按钮。
| 编号 | 区域 | 作用 |
|---|---|---|
| ① | 分支按钮 | 显示当前分支,数字是未提交的改动文件数。 |
| ② | 未提交改动 | 点击 查看 Diff 逐个文件查看改动,用法见 查看结果并验收。 |
| ③ | 常用动作 | 提交、丢弃、更新、推送、储藏、历史、新建分支。每一项都写了对应的 Git 命令和适用场景,右侧数字是相关的文件数或储藏数。 |
| ④ | 分支列表 | 分为最近、本地分支、远端分支。点击远端分支会检出为本地分支。 |
中间的搜索框可以同时搜索分支和动作,用方向键选择,按回车执行。
提交改动
在 Git 菜单中点击 提交改动。
在 ① 中勾选这次要提交的文件,没勾选的文件保持原样留到下次。点击文件旁的眼睛图标可以预览它的改动;右上角可以切换目录树或平铺显示。有未解决冲突的文件时不能提交。
填写提交信息(④)。也可以:
- 在 ② 中搜索并复用以前写过的提交信息;
- 点击 AI 生成(③),由所选 Agent 根据勾选的改动写一条提交信息,默认格式是
feat/fix/refactor/docs/chore: 中文摘要。生成前可以展开 补充信息,写上背景、格式或语言要求,最近用过的补充信息会被记住。生成结果只是草稿,可以修改后再提交。
点击 提交;想顺便上传到远端,点击 提交并推送(⑤)。提交成功但推送失败时,本地提交会保留,之后可以再推送。
推送与更新
推送当前分支 会先列出要上传的提交:
- ① 推送的方向:本地分支 → 远端分支。分支第一次推送时,会同时建立跟踪关系。
- ② 待推送的提交。
- ③ 查看全部改动:查看这些提交合在一起的完整 Diff。
点击 推送 开始上传。网络不好、推送迟迟没有完成时,可以点击 停止推送。
更新当前分支(git pull)把远端的新提交拉到本地。拉取完成后会显示更新明细(改了哪些文件、增删多少行,或者已是最新、失败原因),直到你手动关闭。拉取后出现冲突时,可以进入冲突解决界面处理。
刷新远端信息(git fetch)只查看远端有没有更新,不改动你的本地代码。
管理分支
新建分支:在 Git 菜单中点击 新建分支,输入名字后点击 创建,会基于当前分支创建并切换过去。
其他分支操作:把鼠标移到分支列表中的某个分支上,点击右侧的 ⋯:
可以检出(切换)、合并到当前分支、与当前分支对比、复制分支名、从此分支新建、重命名、删除。删除 只能删除已经合并的分支;强制删除 会删掉没合并的分支,可能丢失提交,请谨慎使用。
丢弃改动
Git 菜单中的 丢弃改动 会把已修改和已删除的文件恢复到最近一次提交,新建的文件会保留。操作前需要再次确认,无法撤销。
提交历史
在 Git 菜单中点击 提交历史:
- ① 按提交信息搜索,或按 今天、近7天、近30天、全部 和自选日期范围筛选。列表到底后可以 加载更多。
- ② 点击某次提交,查看它改了哪些代码。
- ③ 点击提交右侧的 ⋯,可以:
- 检出此提交:把代码切回这个历史版本查看,此时不在任何分支上;
- 回退此提交:生成一条新提交来撤销这次改动,历史记录保留;
- 重置到此提交:把当前分支移回这次提交,可选 soft(改动留在暂存区)、mixed(改动留在工作区)或 hard(丢弃所有改动,不可撤销);
- 复制提交号。
储藏改动
改到一半需要切到别的分支处理急事时,可以先把改动临时收起来。
- ① 填写说明(可选),点击 储藏当前改动。新建的文件也会一起收起。
- ② 已储藏的改动。恢复 会把改动放回来,并保留这条储藏;恢复并删除 放回后删除这条储藏;垃圾桶图标直接丢弃这条储藏。