跳到正文
Caravel使用手册

任务进阶

Git 操作:分支、提交与推送

在体验版中试试

不用打开终端,在 Caravel 里查看改动、提交、推送、切换分支、查看历史和储藏改动。每个按钮旁都标注了对应的 Git 命令。

打开 Git 菜单

点击任务标题下方显示分支名的按钮(例如 main +2),会弹出 Git 菜单。在任务库、编辑器和 关联工作区 的卡片上,也有同样的分支按钮。

编号 区域 作用
① 分支按钮 显示当前分支,数字是未提交的改动文件数。
② 未提交改动 点击 查看 Diff 逐个文件查看改动,用法见 查看结果并验收。
③ 常用动作 提交、丢弃、更新、推送、储藏、历史、新建分支。每一项都写了对应的 Git 命令和适用场景,右侧数字是相关的文件数或储藏数。
④ 分支列表 分为最近、本地分支、远端分支。点击远端分支会检出为本地分支。

中间的搜索框可以同时搜索分支和动作,用方向键选择,按回车执行。

提交改动

  1. 在 Git 菜单中点击 提交改动。

  2. 在 ① 中勾选这次要提交的文件,没勾选的文件保持原样留到下次。点击文件旁的眼睛图标可以预览它的改动;右上角可以切换目录树或平铺显示。有未解决冲突的文件时不能提交。

  3. 填写提交信息(④)。也可以:

    • 在 ② 中搜索并复用以前写过的提交信息;
    • 点击 AI 生成(③),由所选 Agent 根据勾选的改动写一条提交信息,默认格式是 feat/fix/refactor/docs/chore: 中文摘要。生成前可以展开 补充信息,写上背景、格式或语言要求,最近用过的补充信息会被记住。生成结果只是草稿,可以修改后再提交。
  4. 点击 提交;想顺便上传到远端,点击 提交并推送(⑤)。提交成功但推送失败时,本地提交会保留,之后可以再推送。

推送与更新

推送当前分支 会先列出要上传的提交:

  • ① 推送的方向:本地分支 → 远端分支。分支第一次推送时,会同时建立跟踪关系。
  • ② 待推送的提交。
  • ③ 查看全部改动:查看这些提交合在一起的完整 Diff。

点击 推送 开始上传。网络不好、推送迟迟没有完成时,可以点击 停止推送。

更新当前分支(git pull)把远端的新提交拉到本地。拉取完成后会显示更新明细(改了哪些文件、增删多少行,或者已是最新、失败原因),直到你手动关闭。拉取后出现冲突时,可以进入冲突解决界面处理。

刷新远端信息(git fetch)只查看远端有没有更新,不改动你的本地代码。

管理分支

  • 新建分支:在 Git 菜单中点击 新建分支,输入名字后点击 创建,会基于当前分支创建并切换过去。

  • 其他分支操作:把鼠标移到分支列表中的某个分支上,点击右侧的 ⋯:

    可以检出(切换)、合并到当前分支、与当前分支对比、复制分支名、从此分支新建、重命名、删除。删除 只能删除已经合并的分支;强制删除 会删掉没合并的分支,可能丢失提交,请谨慎使用。

丢弃改动

Git 菜单中的 丢弃改动 会把已修改和已删除的文件恢复到最近一次提交,新建的文件会保留。操作前需要再次确认,无法撤销。

提交历史

在 Git 菜单中点击 提交历史:

  • ① 按提交信息搜索,或按 今天、近7天、近30天、全部 和自选日期范围筛选。列表到底后可以 加载更多。
  • ② 点击某次提交,查看它改了哪些代码。
  • ③ 点击提交右侧的 ⋯,可以:
    • 检出此提交:把代码切回这个历史版本查看,此时不在任何分支上;
    • 回退此提交:生成一条新提交来撤销这次改动,历史记录保留;
    • 重置到此提交:把当前分支移回这次提交,可选 soft(改动留在暂存区)、mixed(改动留在工作区)或 hard(丢弃所有改动,不可撤销);
    • 复制提交号。

储藏改动

改到一半需要切到别的分支处理急事时,可以先把改动临时收起来。

  • ① 填写说明(可选),点击 储藏当前改动。新建的文件也会一起收起。
  • ② 已储藏的改动。恢复 会把改动放回来,并保留这条储藏;恢复并删除 放回后删除这条储藏;垃圾桶图标直接丢弃这条储藏。