Jujutsu（jj）社区工具生态指南：从 diff 编辑器、TUI 到 IDE 插件的完整选型参考

Jujutsu（jj）社区工具生态指南：从 diff 编辑器、TUI 到 IDE 插件的完整选型参考

【免费下载链接】jjA Git-compatible VCS that is both simple and powerful项目地址: https://gitcode.com/GitHub_Trending/jj/jj

Jujutsu（简称 jj）不仅是一个简单而强大的 Git 兼容版本控制系统，围绕它还生长出了一个活跃的社区工具生态。本文以官方文档 community_tools.md 为骨架，系统梳理 Diffedit3、GG、Hunk.nvim、jj-fzf、Jujutsu Kaizen、LazyJJ、VisualJJ、Selvejj 等社区维护的周边工具，并结合本仓库源码说明它们在 jj 中如何落地（diff 编辑器配置机制、util completion补全接口等），帮助你按需选型、快速上手。

社区工具生态概览与使用须知

在逐一介绍工具之前，必须先强调官方文档给出的重要声明：

这些列出的工具均由社区维护，Jujutsu 项目本身不审查、不背书、也不保证它们的质量与安全性。

同时官方也提醒，这些工具中的大多数和 Jujutsu 自身一样尚未完全成熟，但它们已经在实际使用中简化了大量工作流、提升了使用体验。因此在选用任何第三方工具前，建议先阅读各工具自己的 README 与文档，评估其维护活跃度与安全性；在关键生产场景中，优先依赖 jj 内置能力或官方配置（如 merge_tools.toml 中随仓库分发的内置工具定义）。

Diffedit3：Meld 的 Web 版替代 diff 编辑器

Diffedit3 是官方文档推荐列表中第一个工具，定位为Meld 的 Web 替代品——因为 Meld 已经不再为所有发行版提供打包，而 Diffedit3 通过浏览器即可获得跨平台的三向 diff/合并体验。其创建者同时也是 Jujutsu 的频繁贡献者。

Diffedit3 并非游离于 jj 之外，而是被深度内置到 jj 的 merge-tools 配置体系中。在本仓库的 cli/src/config/merge_tools.toml 中可以直接看到它的两个预定义配置：

[merge-tools.diffedit3] program="diffedit3" # 17376 是一个"经过验证的随机数"，刻意避开常用的 8000/8080 端口； # 当 5 个首选端口全部被占用时，使用随机端口作为回退。 edit-args = ["$left", "$right", "$output", "--port", "17376-17380", "--port", "0"] diff-args = ["$left", "$right", "--port", "17376-17380", "--port", "0"] [merge-tools.diffedit3-ssh] program="diffedit3" # 与 diffedit3 不同，diffedit3-ssh 不使用随机端口回退， # 因为官方建议用户配置 SSH 端口转发来复用这 5 个端口。 edit-args = ["$left", "$right", "$output", "--port", "17376-17380", "--no-browser"] diff-args = ["$left", "$right", "--port", "17376-17380", "--no-browser"]

从这份配置可以读出几个关键信息：

• $left、$right、$output是 jj 的工具参数占位符，分别代表左侧/右侧文件与输出文件，由 jj 在调用时替换；
• Diffedit3 通过监听17376-17380这一组端口在浏览器中打开界面；如果全部被占用，则回退到随机端口（--port 0）；
• diffedit3-ssh变体专门面向远程/SSH 场景，通过--no-browser不主动拉起浏览器，配合用户自行配置的 SSH 端口转发使用。

如何把 Diffedit3 配置为 jj 的 diff 编辑器

jj 允许通过ui.diff-editor配置项或命令行的--tool参数指定 diff 编辑器。从源码看，当用户没有显式命名工具时，jj 会读取ui.diff-editor配置：在 cli/src/merge_tools/mod.rs 中，DiffEditor::from_settings()从设置中解析该配置项，再通过DiffEditTool::get_tool_config()找到merge-tools.<name>下的配置；而DiffEditor::with_name()（同文件 L245-L254）则直接按指定名字加载工具。也就是说，你既可以在全局配置中写：

[ui] diff-editor = "diffedit3"

也可以在单个命令上临时切换：

jj diffedit --tool diffedit3 jj diff --tool diffedit3

命令行补全同样感知这些工具：在 cli/src/complete.rs 中，diff_editors()把:builtin与所有配置了非空edit-args的 merge-tools 合并为可补全的候选列表。如果edit-args被显式设置为空数组[]，该工具会被从 diff 编辑器候选中排除——这是 TOML 中的有意设计，例如difft这类纯非交互式 diff 格式化器就采用空edit-args。

Hunk.nvim：Neovim 版 diff 编辑器

Hunk.nvim 是一个基于 Neovim 的 jj diff 编辑器，官方文档明确指出它可以作为默认:builtindiff 编辑器的替代品。如果你日常重度使用 Neovim，Hunk.nvim 能让你在熟悉的编辑环境中完成 jj 的 diff 编辑（jj diffedit）与冲突解决。

":builtin"是 jj 内置 diff 编辑器的特殊名称常量，定义于 cli/src/merge_tools/mod.rs。值得留意的是，内置编辑器只是 jj 编辑器家族中的一员：在 cli/src/merge_tools/mod.rs 中还有:ours与:theirs两个特殊合并编辑器（分别代表"取我方/取对方"的自动解决策略）。你可以这样配置使用 Hunk.nvim：

[ui] diff-editor = "hunk.nvim" # 或 hunk.nvim 提供的具体工具名，以该插件 README 为准

GG 与 Visual Jujutsu：图形界面与模糊查找前端

GG —— 跨平台 GUI for JJ

GG 是一个跨平台的 Jujutsu GUI，官方文档评价它"让所有图操作（graph manipulating）工作流变得相当容易"。所谓图操作，对应 jj 中最核心的提交图编辑能力——jj rebase、jj squash、jj new、jj split、jj edit等命令本质上都在改写提交图。GG 通过可视化拖拽/点选把这些操作从命令行搬进图形界面。文档特别建议去阅读它的 README，因为其描述相当详尽。

VJJ —— 终端里的 fzf 包装器

Visual Jujutsu（VJJ）则走向另一个方向：它是fzf（模糊查找器）的 jj 包装器，定位是在终端中交互式使用。fzf 用户熟悉的那套模糊匹配、多选、预览交互被用来驱动 jj 的各类命令，让"在终端里找提交、选提交、执行操作"变得流畅。

jj-fzf：围绕jj log图视图的交互利器

jj-fzf 是 fzf 生态中功能最重的 jj 集成之一，官方文档列举了它的核心能力：

• 以jj log图视图为中心：直接在 fzf 界面中浏览提交图；
• diff 预览：在选中提交时实时预览改动；
• evolution-log 预览：查看提交的演进历史（对应jj evolog）；
• 浏览 op log：操作日志浏览（对应jj op log），便于理解仓库状态如何一步步变化；
• 大量按键绑定：覆盖从 rebase 到 undo 的常用jj操作；
• 帮助处理 divergent commits（分叉提交）：当远端与本地提交产生分叉时提供辅助。

jj 的这些底层能力都有对应的内置模板与命令支撑，例如 cli/src/config/templates.toml 中定义了evolog、log、op_log、show等命令的紧凑/详细输出模板，第三方 TUI 正是基于这些结构化的图与日志信息来渲染自己的界面。

JJ TUI 与 Jujutsu UI（jjui）：两种终端界面方案

JJ TUI（jj_tui）

JJ TUI 是一个用 OCaml 编写的 Jujutsu TUI。官方文档特别强调它"unopinionated（不预设观点）"，且作者对反馈持开放态度——如果你在使用中遇到不符合直觉的设计，可以直接向作者反馈，这正体现了社区工具迭代快、贴近用户的特点。

Jujutsu UI（jjui）

Jujutsu UI（jjui）是另一个用于操作 Jujutsu 的终端用户界面。它和 JJ TUI 同为 TUI 路线，但在交互理念与实现语言上各有取舍，可结合各自 README 对比后选择。

Jujutsu Kaizen 与 VisualJJ：VS Code 插件两派路线

Jujutsu Kaizen（开源，追求 Git 扩展功能对齐）

Jujutsu Kaizen 是VS Code 插件，目标是把 Jujutsu 的优秀体验带入 VS Code 界面。它的开发者当前聚焦于与 VS Code 内置 Git 扩展的常用功能对齐，例如通过 Source Control 视图完成各种操作。也就是说，如果你习惯了 VS Code 左侧"源代码管理"面板的操作方式，Kaizen 力图让你以同样的肌肉记忆操作 jj。

VisualJJ（原生集成，非开源）

VisualJJ 同样是 VS Code 插件，但它走的是原生集成路线：不依赖 Git colocation（即不要求仓库同时以 Git 工作副本方式存在），直接在 VS Code 内对接 jj 的数据模型。官方文档特别注明，与本页其他工具不同，VisualJJ 不是开源的——这是一个需要在实际选型时纳入考量的因素（安全性、可审计性与长期维护风险）。

LazyJJ：lazygit 风格的 TUI

LazyJJ 是lazygit 风格（inspired by lazygit）的 Jujutsu TUI。如果你熟悉 lazygit——那个以"无需记忆命令、全键盘操作、清晰三栏布局"著称的 Git TUI——那么 LazyJJ 会把同样的体验映射到 jj 的工作流上，尤其适合从 Git 迁移到 jj、又想保留 lazygit 操作习惯的用户。

Selvejj：JetBrains 系列 IDE 的一等公民集成

Selvejj 是一个JetBrains 插件，目标是把 Jujutsu 作为一等公民（first-class）VCS 集成到 JetBrains IDE 中。这区别于把 jj 仓库当普通目录浏览的通用插件：Selvejj 试图在 IDE 的 VCS 面板中直接呈现 jj 的提交、书签、图结构与操作命令，让 IntelliJ IDEA、PyCharm、GoLand 等 JetBrains 系产品的用户无需切出 IDE 就能完成 jj 的核心操作。

PSCompletions：PowerShell 下的补全增强

PSCompletions 是一个PowerShell 补全管理器，目标是提供更好、更简单的 Tab 补全体验。官方文档给出了两种使用方式：

• 直接通过psc add jj安装 jj 的补全；
• 或者用它为 jj 官方补全提供更完善的补全菜单（更友好的候选展示、分组等）。

jj 官方本身就提供了多 shell 的补全脚本生成能力：在 cli/src/commands/util/completion.rs 中可以看到，jj util completion支持 bash、fish、zsh、nushell，例如：

source <(jj util completion bash) # bash jj util completion fish | source # fish jj util completion zsh # zsh（配合 compinit 使用） jj util completion nushell | save -f "completions-jj.nu" # nushell

PSCompletions 的工作是在 PowerShell 侧把这套体验做得更顺手。此外，jj 的命令参数级补全是动态的：以 cli/src/complete.rs 中的diff_editors()为例，它会基于当前仓库配置实时生成可补全的 diff 编辑器候选（:builtin+ 已配置工具），这保证了在 PowerShell 等 shell 中补全到的工具名永远与你的配置一致。

如何发现更多社区工具与集成

官方文档明确指出，本页只是社区工具的一个快照，更多社区贡献的工具与集成收录在Jujutsu 项目的 Wiki中。以下几条实用建议：

1. 以 Wiki 为持续更新的清单：工具列表会随社区贡献不断增长，Wiki 是最新信息的来源；
2. 优先选择与本仓库内置配置有交集的工具：例如 Diffedit3 直接出现在 merge_tools.toml 中，说明它已被 jj 生态深度接纳，配置成本最低；
3. 评估时参考官方文档的核心声明：这些工具均属社区维护，未被 jj 项目审查、背书或作质量/安全担保，接入生产环境前请自行验证。

总结：按工作流场景选择你的工具组合

最后，把本文涉及的社区工具按使用场景归纳，便于快速决策：

无论选择哪一套组合，都可以用 cli/src/config/merge_tools.toml 与 cli/src/merge_tools/mod.rs 中呈现的机制把它们接入 jj：配置ui.diff-editor/ui.merge-editor，或通过--tool参数按命令临时切换。工具生态的本质是让 jj 的底层能力（提交图、op log、diff 编辑、补全）以你熟悉的方式呈现出来——先选对工具，再逐步深入 jj 本身的强大工作流。

【免费下载链接】jjA Git-compatible VCS that is both simple and powerful项目地址: https://gitcode.com/GitHub_Trending/jj/jj