返回资讯中心
外部精选
软件工程
#开发者实时流

Jujutsu 入门指南:面向 Git 用户的 jj 版本控制系统介绍

来源标题:Jujutsu Primer

这篇指南面向熟悉 Git 的读者,简要介绍 Jujutsu(jj)版本控制系统。jj 提供易学且能组合成强大工作流的版本控制原语,自动 rebase 和原生 undo 等功能弥补了 Git 的不足。jj 可与 Git 在同一仓库中并行使用,用户无需完全脱离 Git 即可试用。

Hacker News 最新renehsz2026/11/20 · 今天30 分钟阅读

以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →