返回资讯中心
外部精选
软件工程
#社区热议

写给 Git 用户的 Jujutsu 版本控制入门指南

来源标题:Jujutsu Primer

一篇面向熟悉 Git 用户的 Jujutsu(jj)版本控制系统中入门指南发布。Jujutsu 提供自动 rebase 和原生 undo 等功能,可与 Git 在同一仓库中并行使用,无需完全脱离 Git 即可试用。文章还列出了 macOS、Arch Linux、NixOS 及源码等安装方式。

Hacker Newsrenehsz2026/11/20 · 今天30 分钟阅读

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

打开原文
去社区讨论 →