
Jujutsu 入门指南:面向 Git 用户的 jj 版本控制系统介绍
来源标题:Jujutsu Primer
这篇指南面向熟悉 Git 的读者,简要介绍 Jujutsu(jj)版本控制系统。jj 提供易学且能组合成强大工作流的版本控制原语,自动 rebase 和原生 undo 等功能弥补了 Git 的不足。jj 可与 Git 在同一仓库中并行使用,用户无需完全脱离 Git 即可试用。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
本文是一篇(略为)简短的 Jujutsu(jj)版本控制系统(VCS)入门介绍,面向熟悉 Git 的读者。
jj 提供的版本控制原语简单易学,却能优雅地组合成强大的工作流。自动 rebase 和原生 undo 之类的特性磨平了 Git 的尖锐棱角。最终,你会自然而然地发现一些新的强大工作流,而这些工作流在大多数其他 VCS 工具里都过于繁琐、根本不会去尝试。
如果你平时在 Git 仓库里工作,今天就可以试用。Jujutsu 和 Git 可以在同一个仓库里并行使用,所以你可以拿自己的 git 仓库试一试 jj,而不必彻底脱离 git。
个人而言,我认为 jj 大幅提升了我的效率,因为它让我不必把版本控制的各种琐事记在工作记忆里。自动 rebase 也让 stacked diff 工作流变得非常轻松,还减少了我工作记忆的反复切换。而且它用起来本身就很有趣。
官方安装说明在这里,下面列出几种常见方式:
macOS
brew install jj
Arch Linux
pacman -S jujutsu
NixOS (ideally from nixpkgs-unstable)
nix-shell -p jujutsu
From source
(Requires a recent Rust and ~/.cargo/bin on your PATH)
cargo install --locked --bin jj jj-cli
初始化与配置
在已有的 git 仓库中运行:
jj git init
从此以后,jj 与 git 的仓库状态会自动同步。
要全局设置你的用户信息,可以运行类似这样的命令:
jj config set --user user.name "Some One" jj config set --user user.email "someone@example.com"
你可以用编辑器编辑自己的用户级 jj TOML 配置:
jj config edit --user
除了 --user 作用域,jj config 还有 --repo 和 --workspace 作用域。查看合并后的配置:
jj config list
提交与变更
一个 commit(提交),也叫 revision(修订),本质上与 git commit 是同一回事。它表示仓库状态在某一时刻的快照,其父级是一个或多个父仓库快照。它通常被可视化为相对于单个父提交的 diff;如果是合并提交,则是合并后相对于多个父提交的 diff。
使用 Git 仓库作为后端时,jj 的 commit ID 与 git 的 commit ID 相同:一段十六进制字符串形式的哈希。在下面的 jj log 输出里,右侧的十六进制哈希 2bea5e3d 和 849165bc 就是 commit ID。
$ jj log │ (empty) (no description set) ◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d │ Adjust config ~
左边的 ID(royxmykx 和 kpqxywon)是 change ID,它们是逻辑变更在物理上不断演化时的稳定标识符。我们会在下一节进一步讨论。
commit ID 和 change ID 都可以用无歧义(唯一)的前缀简写来引用。jj 会贴心地高亮大多数 ID 的最短唯一前缀,方便你手动输入。例如,不必复制粘贴 kpqxywon,我们可以只敲一个前缀,最短可以短到一个字符 k。
我们可以用 jj show 查看提交 2bea5e3d,用它的短前缀 2 即可。
$ jj show 2 Commit ID: 2bea5e3d1992a60ba9ee52c6ce37c55adba9e8fb Change ID: royxmykxtrkrqppotnrvutxlvrvqyxmy Bookmarks: main main@git main@origin Author : Ethan Lowman ethan@example.com (2026-11-15 12:10:46) Committer: Ethan Lowman ethan@example.com (2026-11-15 12:10:46) Adjust config diff --git a/config.py b/config.py index 7366a4e31d..174ffea06b 100644 --- a/config.py +++ b/config.py -DEFAULT_LIMIT = 10 +DEFAULT_LIMIT = 20
不少人会配置自定义的 diff 格式化工具,比如 Delta。感兴趣的话可以看看配置文档。
我们再来看一眼提交图:
$ jj log │ (empty) (no description set) ◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d │ Adjust config ~
在提交 849165bc 上,你会看到图节点上有个 @ 符号。它代表我们工作副本的快照,也就是我们实际检出到本地目录里的代码。我们可以用多种方式查看这个特殊的提交指针:
jj show 显示提交详情和 diff,这里的 diff 是空的。
$ jj show Commit ID: 849165bca19639dbd6ccb53e8c1340e78c36d59a Change ID: kpqxywonksrltlrkyqukqqsxpltznztk Author : Ethan Lowman ethan@example.com (2026-11-15 12:17:12) Committer: Ethan Lowman ethan@example.com (2026-11-15 12:17:12) (no description set)
jj status 显示仓库状态以及 diff 统计。
$ jj status The working copy has no changes. Working copy (@) : kpqxywon 849165bc (empty) (no description set) Parent commit (@-): royxmykx 2bea5e3d main | Adjust config
jj diff 的用法和 git diff 很像。这里它的输出为空,因为当前工作副本相对于父提交没有任何改动。
$ jj diff
这个输出没什么意思,因为 @ 没有任何改动。我们做个示例改动,看看会发生什么。如果我们编辑 main.py 并重新运行 jj show,会看到:
$ jj show Commit ID: 66b59f20c534705cfb753c722222290e9185b22c Change ID: kpqxywonksrltlrkyqukqqsxpltznztk Author : Ethan Lowman ethan@example.com (2026-11-15 12:26:43) Committer: Ethan Lowman ethan@example.com (2026-11-15 12:26:43) (no description set) diff --git a/main.py b/main.py new file mode 100644 index 0000000000..c74cd2e0e0 --- /dev/null +++ b/main.py +def my_new_feature():
- pass
$ jj log │ (no description set) ◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d │ Adjust config ~
你会注意到有几处变化。工作副本已经被自动提交,@ 也不再标记为 (empty)。@ 的新 commit ID 是 66b59f20,因为我们添加了改动;但 66b59f20 的 change ID 仍然是 kpqxywon。jj 没有 git 那样的暂存区,所以我们不必手动 add 文件。当我们编辑文件后运行 jj 命令来查看或修改仓库状态时,jj 会自动把工作副本快照成一个新的物理提交,归属于相应的逻辑变更。
我们给这个变更加一段描述(也叫 commit message)。既可以运行 jj desc 打开编辑器,也可以用 -m 直接提供。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。