Ethan Lowman 在《Jujutsu Primer》中给 Git 用户提供了一条试用路径:在现有 Git 仓库里运行 jj git init,继续使用原来的 Git 远端,同时用 Jujutsu(jj)整理本地提交。它最能省工夫的场景是堆叠变更。评审要求你回头修改底层实现时,依赖它的后续提交可以自动跟上。
这个变化把本地编辑和团队协作的成本分开了。开发者可以少做几次交互式 rebase,但一串 GitHub PR 能否维持正确的依赖关系,仍取决于远端如何保留变更身份,以及团队怎么发布和更新分支。
Jujutsu 给反复改写的变更保留了身份
运行查看或修改仓库状态的 jj 命令时,jj 会把工作副本 @ 自动快照为提交。Git 用户熟悉的暂存区在这里省掉了。写功能写到一半,可以切回前面的变更继续改,手头的工作已经有快照可回看,回头再接着写。
底层 Git 提交仍以 commit ID 标识快照。改代码或改提交说明,哈希都会变。Jujutsu 另给同一项逻辑变更分配一个稳定标识 change ID。即使提交改写了,开发者仍可用原来的 change ID 找到这项工作。如果同一个 change ID 演变出多个版本,较新的版本也改进了对此类分歧的处理。
比如先改公共接口,再写调用代码。评审要求修改接口时,jj 会把依赖它的后代提交自动变基到改写后的版本上,省去手动重排提交的步骤。发生内容冲突时,仍要由开发者处理。调错了历史,可以通过原生撤销回退操作,jj op log 则能用来查操作记录。较新的版本还会记下工作区名称。
<svg viewBox='0 0 760 222' width='100%' height='222' role='img' aria-label='修改早期变更后保留变更身份并自动重排后代提交'>
<rect x='1' y='1' width='758' height='220' rx='14' fill='#fbf9f4' stroke='#e2dccf'/>
<text x='32' y='39' fill='#b25a3a' font-size='20' font-weight='700'>本地改写如何传递</text>
<line x1='32' y1='56' x2='728' y2='56' stroke='#e2dccf' stroke-width='1'/>
<rect x='32' y='88' width='200' height='86' rx='9' fill='#fbf9f4' stroke='#e2dccf'/>
<rect x='280' y='88' width='200' height='86' rx='9' fill='#fbf9f4' stroke='#b25a3a'/>
<rect x='528' y='88' width='200' height='86' rx='9' fill='#fbf9f4' stroke='#e2dccf'/>
<line x1='241' y1='131' x2='263' y2='131' stroke='#7a7266'/>
<polygon points='263,126 272,131 263,136' fill='#7a7266'/>
<line x1='489' y1='131' x2='511' y2='131' stroke='#7a7266'/>
<polygon points='511,126 520,131 511,136' fill='#7a7266'/>
<text x='132' y='123' text-anchor='middle' fill='#2c2822' font-size='17' font-weight='700'>修改早期变更</text>
<text x='132' y='149' text-anchor='middle' fill='#7a7266' font-size='13'>生成新快照</text>
<text x='380' y='123' text-anchor='middle' fill='#b25a3a' font-size='17' font-weight='700'>保留变更身份</text>
<text x='380' y='149' text-anchor='middle' fill='#7a7266' font-size='13'>提交哈希改变</text>
<text x='628' y='123' text-anchor='middle' fill='#2c2822' font-size='17' font-weight='700'>自动重排后代</text>
<text x='628' y='149' text-anchor='middle' fill='#7a7266' font-size='13'>接上新父提交</text>
</svg>
同仓库可以混用,跨远端要认得同一项变更
Jujutsu 用 Rust 编写,有自己的版本控制模型。可插拔的 Git 后端负责读写普通 Git 提交和连接 Git 远端,早期集成用 libgit2,后来转向 Rust 的 gitoxide。在共置模式(colocated)下,jj 命令会触发 Git 状态的导入与导出。如果刚用 Git 移动了分支,再执行 jj 命令时才会发生相应的导入,这和实时同步有区别。
跨机器协作还有一个前提。如果同事改写了一项提交,你从远端取回后,jj 要自动把本地后代接到新版上,得靠远端保留 change ID。一旦丢了这个标识,工具就缺少识别同一项变更的依据,开发者可能要手动核对并重接提交。团队试用时,验证一次由同事改写、自己拉取的流程,比只在本机试一次 rebase 更能说明问题。
Graphite 的发布与评审能力仍要单独算账
Jujutsu 的长处是编辑本地变更图。Graphite 更偏向 GitHub 上成串 PR 的发布、追踪、评审和合并。前一项 PR 更新后,后续 PR 的基础分支由谁调整、评审者该看哪一版,属于发布与评审的工作。用 jj 改好了本地提交,这些操作仍需团队约定或自动化来完成。
<svg viewBox='0 0 760 238' width='100%' height='238' role='img' aria-label='Jujutsu侧重本地变更图,Graphite侧重堆叠PR的发布和评审'>
<rect x='1' y='1' width='758' height='236' rx='14' fill='#fbf9f4' stroke='#e2dccf'/>
<text x='32' y='39' fill='#b25a3a' font-size='20' font-weight='700'>同一组变更的两段工作</text>
<line x1='32' y1='56' x2='728' y2='56' stroke='#e2dccf' stroke-width='1'/>
<rect x='32' y='80' width='334' height='122' rx='9' fill='#fbf9f4' stroke='#e2dccf'/>
<rect x='394' y='80' width='334' height='122' rx='9' fill='#fbf9f4' stroke='#e2dccf'/>
<text x='54' y='111' fill='#2c2822' font-size='18' font-weight='700'>Jujutsu</text>
<text x='416' y='111' fill='#2c2822' font-size='18' font-weight='700'>Graphite</text>
<line x1='54' y1='123' x2='344' y2='123' stroke='#e2dccf'/>
<line x1='416' y1='123' x2='706' y2='123' stroke='#e2dccf'/>
<text x='54' y='150' fill='#2c2822' font-size='16' font-weight='700'>本地变更图</text>
<text x='416' y='150' fill='#2c2822' font-size='16' font-weight='700'>堆叠 PR 工作流</text>
<text x='54' y='177' fill='#7a7266' font-size='13'>编辑、重排与撤销</text>
<text x='416' y='177' fill='#7a7266' font-size='13'>发布、评审与合并</text>
</svg>
想试用的团队可以保留 GitHub PR,只让常维护堆叠变更的开发者先用 jj。发布端可用脚本或 jj-spr、jj-stack 等社区工具同步分支和 PR 的基础分支,再约定谁负责改写已推送的分支、什么时候通知评审者。已经依赖 Graphite 仪表盘和合并队列的团队,还得把这些能力的接续成本算进迁移预算。
团队试用要测整轮评审的成本
Jujutsu 源于 Martin von Zweigbergk 在 2019 年末开始的业余项目。GitHub 上首个发布版本是 2022 年 3 月 13 日的 v0.3.0 预发布版,此前已有 0.2.0 等版本。项目后来与 Google 的全职工作产生关联,长期维护和支持仍应按社区项目来评估。
常把功能拆成相互依赖的 PR 的开发者,可以拿一轮真实评审做小范围试用,看改动底层提交后,后续分支能否正确更新,CI 能否在预期的提交上运行,评审者是否要重新找差异。平时很少改写历史、一个功能通常只开一个 PR 的团队,留在 Git 上往往更省事。决定是否推广的指标,是一轮评审少了多少手工操作,而非本地少敲了多少命令。
