Table of Contents
修订时间:2026.10 适用工位:资料管理员
git仓库网页版无法进行文件批量操作,需要git仓库管理员使用jujutsu软件进行整理
1、安装jujutsu
本教程基于linux操作系统,首先要确保主机上已安装cargo,如没有可尝试如下语句或其他方式进行安装
yum install cargo % (debian建议使用rustup安装,sudo apt install rustup && rustup update && rustup stable install)
安装完成后,执行下方命令进行jujutsu(下文全部使用jj代替)安装
cargo install --locked --bin jj jj-cli
安装完成后有可能出现在/home/$usr/.cargo/bin/下存在jj这个二进制文件的情况(或者是/root/.cargo/bin/下),这时可进入对应目录使用mv jj /usr/bin/将其挪入环境目录,随后可使用jj -V进行测试,若正常输出即代表安装成功
使用git -v确认自己的git版本在2.41.0及以上版本,若未安装git可使用yum install git
可执行source <(jj util completion bash)加装命令自动补全
2、拉取git仓库到本地建立同步
可使用jj config set --user user.name "username"和jj config set --user user.email "xxx"配置之后的提交信息
仓库拉取可使用jj git clone --colocate https://git.xxxxx.xxx/wpec/xxx.git进行拉取,其中colocate是为了防止特殊情况可直接使用git系列命令进行操作,拉取时会要求你输入用户名和密码,输入即可
拉取完成后,当前操作目录下会生成一个文件夹,使用cd命令进入
执行jj st(st即为status)可得到如下状态
The working copy has no changes.
Working copy (@) : lwmkzqtv 5586d33a (empty) (no description set)
Parent commit (@-): wrkuwtxt 20239f0b 主分支 | 更新
在上面中我们可以看到有一个提交前面有个(@),这代表该提交为你当前的工作提交,可以通过@-和@+来标记其父提交和子提交。我们可以看到每个提交后都有两个短字符串,前一个是变更ID,后一个是提交ID
执行完jj st后再执行jj log就可以看到该仓库的提交历史了,例如
@ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss 5586d33a
│ (empty) (no description set)
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
可以看到,其中内容和status里的内容是一一对应的
3、用jujutsu批量修改git仓库文件
新分支修改
对本地仓库文件的增加,删除,修改都统一被视作更改
先执行jj describe在其中描述自己要进行什么更改,更改完后可注意到当前分支的(empty)之后的部分已经变成了jj describe中书写的部分,如下图所示,同时我们还发现其提交id发生了改变
@ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss b9787e35
│ (empty) 增加文件
这里我们随便对本地仓库的文件进行变更,比如新创建一个文件。在本地文件夹中进行修改后,重新jj describe。此时发现(empty)消失了并且提交id又发生了改变,到目前为止我们已经完成了一次在本地的变更,此时可以选择提交到远程仓库,或者是在当前基础上继续创建新的变更,然后将多个变更作为一次变动进行提交
@ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
再创建一个更改
执行jj new后相当于创建了一个新的变更,此时,log变成了这样,@已经移动到当前创建的变更上了
@ vkzzuzlo user1@hostname yyyy-mm-dd hh:mm:ss c4e170d5
│ (empty) (no description set)
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
之后可以继续在当前变更上进行各种操作,比如对我们刚刚新增的文件内容进行修改,修改完之后新分支的(empty)就会消失,此时可以使用jj commit来同时完成jj describe和jj new的功能,执行完jj commit之后如下所示:
@ xxqwqsqo user1@hostname yyyy-mm-dd hh:mm:ss adadef9d
│ (empty) (no description set)
○ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
(注:由于我执行过一次删除分支操作,这里可以注意到@的父变更id发生了改变,但是不影响)
此时我在本地已经完成了两次变更,如果我希望将两个变更合并成一个我们可以使用jj squash --from zlwsonow --to lwmkzqtv,即将子提交合并到父提交里,此时会要求你修改describe的内容,执行完效果如下
@ xxqwqsqo user1@hostname yyyy-mm-dd hh:mm:ss 0f8b26a3
│ (empty) (no description set)
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss 43fe3c21
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
可以看到只剩下一个变更了
删除更改
使用jj abandon 变更id可以删除一个变更,比如我们删除lwmkzqtv这条变更,执行完成后如下所示
@ xxqwqsqo user1@hostname yyyy-mm-dd hh:mm:ss bd20764b
│ (empty) (no description set)
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b │ 更新
如果我们此时后悔了,则可以执行jj undo撤销上一步操作恢复到删除之前的状态,现在我们恢复合并变更之前的状态
@ xxqwqsqo user1@hostname yyyy-mm-dd hh:mm:ss adadef9d
│ (empty) (no description set)
○ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
从特定变更进行修改
如果我们希望从lwmkzqtv开始进行新的变更操作,可以在jj new的后面增加变更id,即jj new lwmkzqtv,执行完如下图所示
@ svrnnmpp user1@hostname yyyy-mm-dd hh:mm:ss a432047d
│ (empty) (no description set)
│ ○ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
├─╯ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
可以看到,原来的zlwsonow变更旁多了一个同样从lwmkzqtv衍生的svrnnmpp变更并且当前工作变更已自动切换至svrnnmpp,此时可以在svrnnmpp上进行各种操作,如果我们又希望回去更改zlwsonow则可以使用jj edit命令后跟变更id,即jj edit zlwsonow执行后如下图所示
@ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
│ ○ svrnnmpp user1@hostname yyyy-mm-dd hh:mm:ss 01881e3e
├─╯ (empty) add A
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
可以看到,当前分支的@标记已经转移到zlwsonow上了
更改合并和冲突处理
为了演示,我在zlwsonow和svrnnmpp上都对同一个文件进行了不同的修改,现在我们将这两个更改进行合并,同级别分支合并使用jj rebase -r xxx -d xxx,第一个参数为被合并的分支,第二个参数为合并分支,执行jj rebase -r svrnnmpp -d zlwsonow结果如下所示(先将工作分支切换到zlwsonow上)
× svrnnmpp user1@hostname yyyy-mm-dd hh:mm:ss f5f8a7d1 (conflict)
│ add A
@ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
如上所示,虽然合并成功了,但是显示有冲突,该分支以x进行标记,jj和git的不同之处在于除非真的需要提交这一变更,否则都可以先放着该冲突不进行处理,我们可以继续在zlwsonow上进行jj new等操作,如果要解决该冲突,我们可以执行jj edit svrnnmpp,此时会报告
Warning: There are unresolved conflicts at these paths:
test1.txt 2-sided conflict
这代表该文件存在冲突
<<<<<<< conflict 1 of 1
+++++++ zlwsonow 0264e702 "修改文件内容" (rebase destination)
11111
%%%%%%% diff from: lwmkzqtv ce4c485c "增加文件" (parents of rebased revision)
\\\\ to: svrnnmpp 7de18c3e "add A" (rebased revision)
+222
>>>>>>> conflict 1 of 1 ends
这个是我进行修改的文件的不同内容,在其中一个分支中我将其修改为11111,在另一个分支中我将其修改为222,但可以看到这个语法非常不友好,所以我们尽可能不要产生冲突。这里我们对test1.txt进行修改后可以发现
@ svrnnmpp user1@hostname yyyy-mm-dd hh:mm:ss 0650bf53
│ add A
○ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支 20239f0b
│ 更新
可以注意到该变更分支已经和其他变更分支没有任何区别了
4、提交
使用jj进行提交时需要先打上书签再指定对哪个书签进行提交,比如对svrnnmpp以及之前的所有修改统一作为一个整体进行提交时我们应执行如下步骤
- 执行
jj new创建一个空提交 - 执行
jj bookmark set -r '@-' main,将当前提交的父提交设置为main。注意!由于显示的bookmark名为“主分支”,因此我要执行的命令为jj bookmark set -r '@-' 主分支,此时状态为
@ pltrynxv user1@hostname yyyy-mm-dd hh:mm:ss 981bf407
│ (empty) (no description set)
○ svrnnmpp user1@hostname yyyy-mm-dd hh:mm:ss 主分支* 0650bf53
│ add A
○ zlwsonow user1@hostname yyyy-mm-dd hh:mm:ss 0264e702
│ 修改文件内容
○ lwmkzqtv user1@hostname yyyy-mm-dd hh:mm:ss ce4c485c
│ 增加文件
◆ wrkuwtxt user2@hostname yyyy-mm-dd hh:mm:ss 主分支@origin 20239f0b
│ 更新
原来的主分支标签后面多了一个origin代表远程,本地的主分支现在是svrnnmpp
- 执行
jj git push后,从lwmkzqtv到svrnnmpp的变更都会被提交至远程仓库
某些时候我们有可能碰到远程仓库在自己提交前又出现了更改的情况,此时提交会失败,可以执行jj rebase -d 主分支@origin拉取新变更内容并处理完冲突后重新提交
总结(简明文件变更流程)
- cd到需要修改的仓库中
- 设置节点到main jj bookmark set main
- 设置文件大小上限 jj --config snapshot.max-new-file-size=66418259 status
- 运行后在弹出文件第一行写变化描述,保存后关闭文件 jj describe
- 进行文件上传或编辑 在本地仓库进行修改
- 然后push到网站上 jj git push
- push成功后,会自动新建一个修改,重复步骤2-6即可