
写给 Git 用户的 Jujutsu 版本控制入门指南
来源标题:Jujutsu Primer
一篇面向熟悉 Git 用户的 Jujutsu(jj)版本控制系统中入门指南发布。Jujutsu 提供自动 rebase 和原生 undo 等功能,可与 Git 在同一仓库中并行使用,无需完全脱离 Git 即可试用。文章还列出了 macOS、Arch Linux、NixOS 及源码等安装方式。
以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Jujutsu 入门指南
本指南面向熟悉 Git 的读者,简要介绍 Jujutsu(jj)版本控制系统(VCS)。jj 提供的版本控制原语简单易学,却能优雅地组合成强大的工作流。自动 rebase 和原生 undo 等功能柔化了 Git 的尖锐边缘。最终,你会自然而然地发现一些新的强大工作流,而这些工作流在大多数其他 VCS 工具中尝试起来会过于繁琐。
如果你在 Git 仓库中工作,今天就可以试用它。Jujutsu 和 Git 可以在同一个仓库中并排使用,因此你可以在自己的 git 仓库上试用 jj,而无需完全脱离 git。
就个人而言,我认为 jj 大幅提升了我的效率,因为它让我不必把版本控制的记账工作留在工作记忆中。自动 rebase 还让堆叠式 diff 工作流变得非常容易,并减少了我的工作记忆的反复切换。它也是一个用起来很有趣的工具。
官方安装说明在这里,但以下是几种常见方法:
macOS
brew install jj
Arch Linux
pacman -S jujutsu
NixOS(最好从 nixpkgs-unstable 安装)
nix-shell -p jujutsu
从源码安装
(需要较新的 Rust,且 ~/.cargo/bin 在你的 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 那样的暂存区,所以我们不必手动添加文件。当我们在编辑文件后运行 jj 命令来检查或修改仓库状态时,jj 会自动将工作副本快照为相关逻辑变更的新物理提交。
让我们给这个变更添加一个描述(也称为提交信息)。我们可以运行 jj desc(会打开编辑器),或者直接用 -m 提供。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。