Rift：Git Worktrees 的更优替代方案

背景

在复杂的软件开发工作中，开发者经常需要同时处理多个分支或功能特性。虽然 git worktrees 是 Git 官方提供的用于在同一仓库中管理多个工作区的标准工具，但它存在明显的性能瓶颈和空间开销问题。传统的 git worktrees 在创建新工作区时，往往涉及大量的文件复制操作，这不仅耗时（特别是在大型代码库中），还会占用大量的磁盘空间。

此外，现有的工作区管理方式在跨平台兼容性、初始化速度以及与现代运行时环境（如 Node.js 或 Bun）的集成方面也存在不足。Hacker News 上近期受到关注的开源项目 Rift 正是为了解决这些痛点而生。它旨在提供一种比 git worktrees 更快、更节省空间且体验更流畅的工作区管理方案。

核心内容

Rift 是一个基于文件系统快照技术（Snapshotting）构建的工具，主要面向 macOS 和 Linux（特别是使用 Btrfs 文件系统的用户）。它通过利用现代操作系统的底层特性，实现了近乎瞬时的工作区创建和极低的存储占用。

1. 核心技术原理

Rift 的核心优势在于其底层存储机制：

• 写时复制（Copy-on-Write, CoW）：Rift 不复制实际文件数据，而是创建指向原始数据的引用。这意味着无论代码库有多大，创建新工作区几乎不占用额外的磁盘空间，直到工作区内的文件发生修改。
• 瞬时创建：得益于 CoW 技术，Rift 在包含 10GB 数据的文件夹中创建新工作区的时间小于 0.1 秒，远超传统 git worktrees 的速度。
• 平台特定的快照实现：
  • Linux (Btrfs)：在 Linux 上，Rift 利用 Btrfs 子卷（subvolume）和重链接（reflink）功能。首次初始化普通 Btrfs 目录时，它会执行重链接导入到新的 Btrfs 子卷，并将其交换到相同路径。如果根目录已注册，则不进行转换；如果缺少 .rift 标记，则会恢复标记并完成必要的转换。
  • macOS (APFS)：在 macOS 上，Rift 使用 APFS 的 clonefile 系统调用来创建可写的快照。

2. 命令行界面 (CLI) 功能

Rift 提供了一套简洁高效的 CLI 命令来管理工作区生命周期：

• rift init：初始化 Rift 根目录。
  • 默认行为：在当前目录或最近的 Git 根目录之上选择现有的 Rift 根，或创建新的 Git 根。
  • 选项 --here：强制在选定目录精确初始化。
  • 状态恢复：如果 .rift 标记缺失，命令会自动恢复并补全所需的转换。
• rift create：创建新的工作区。
  • 默认行为：向上搜索 .rift 标记，复制受管理的 workspace，记录直接父级，并将新工作区的路径打印到 stdout。
  • 选项 --name：指定工作区名称（如 rift create --name parser-fix）。
  • 选项 --into：指定存储路径（如 rift create --into /fast/rifts）。
  • 行为细节：当工作区是 Git 仓库时，新工作区将处于 detached HEAD 状态，并保留索引和工作树状态。
• rift list / rift ancestors：
  • list：打印直接活动的子工作区。
  • ancestors：按从近到远的顺序打印父工作区。
• rift remove：移除工作区。
  • 默认行为：将当前创建的工作区子树移动到相邻的 .trash 存储中。
  • 选项 -f：强制注销源根（源目录保留在磁盘上，移除 .rift 标记，现有子代移入 trash，缺失的子代从注册表中移除）。
  • 选项 --children：删除子代，保留选定的工作区。
• rift gc：垃圾回收。物理删除 .trash 存储并修剪缺失的条目。

3. 集成与扩展性

Rift 不仅是一个 CLI 工具，还提供了丰富的集成能力：

• Shell 集成：通过 eval "$(rift shell-init zsh)"（或 bash）注入 shell 包装器。在执行 init、create 或移除当前工作区后，自动切换目录，提升用户体验。
• FFI 库支持：Rift 允许作为 FFI（外部函数接口）库与 Bun 或 Node.js 集成。
  • 安装方式：npm install -g rift-snapshot 或 bun add -g rift-snapshot。
  • JavaScript API 示例：

    import { create, list, remove, gc } from "rift-snapshot";
    const workspace = create({ from: process.cwd(), name: "schema-work" });
    console.log(list({ of: process.cwd() }));
    remove({ at: workspace });
    gc();
    

  • Node.js 要求：Node 绑定需要 Node.js 26.1 或更高版本的实验性 FFI API，并需传递 --experimental-ffi 和 --allow-ffi 权限标志。
• 数据存储结构：
  • 每个受管理的工作区都有一个包含其标识符的 .rift 标记文件。
  • 使用 SQLite 注册表存储路径、父级标识符和垃圾条目。
  • 默认存储布局：

    ~/code/app/                  # 源工作区
    ~/code/.rifts/app/parser-fix/ # 创建的工作区
    ~/code/.rifts/app/.trash/     # 移除的工作区存储
    

4. 安装与构建

• 预编译版本：可从 GitHub Releases 获取 Release archives。
• 从源码构建：

  cargo test --workspace --locked
  ./scripts/install.sh
  

  scripts/install.sh 会将优化的 CLI 二进制文件安装到 ${CARGO_HOME:-$HOME/.cargo}/bin/rift。

关键要点

• 极致性能：相比传统 git worktrees，Rift 提供了 < 0.1 秒的创建速度和基于写时复制（CoW）的极低磁盘空间占用。
• 文件系统依赖：目前主要支持 macOS (APFS) 和 Linux (Btrfs)。其核心优势依赖于这些文件系统提供的快照和重链接功能。
• 无缝 Shell 体验：内置 shell 包装器，在创建工作区或切换后自动处理目录变更，减少手动操作。
• 开发者友好集成：提供 Node.js 和 Bun 的 FFI 绑定，允许开发者在 JavaScript/TypeScript 环境中直接调用 Rift 功能，便于构建自动化工具或 IDE 插件。
• 安全删除机制：采用“软删除”策略，移除的工作区首先移至 .trash 目录，通过 rift gc 命令进行物理清理，防止误操作导致数据丢失。
• SQLite 注册表：使用轻量级的 SQLite 数据库管理所有工作区的元数据、层级关系和垃圾回收状态。
• 开源协议：采用 MIT 许可证，允许自由使用和修改。

意义与影响

Rift 的出现标志着版本控制工作区管理向“即时化”和“轻量化”迈出了重要一步。对于拥有大型代码库（如超过 10GB）的开发团队而言，Rift 能够显著减少上下文切换的时间成本，提升开发效率。

1. 推动文件系统特性在开发工具中的应用：Rift 充分利用了 Btrfs 和 APFS 的高级特性，展示了现代文件系统如何被用于解决传统工具（如 Git）长期存在的性能瓶颈。这可能会激励