Lib.rs

›
#git-branchless #git-workflow #git-branch #commit #git-rebase #git-tool #undo

bin+lib git-branchless-test

git-branchless 的支持库

由 Waleed Khan 和 29 位贡献者

4 个版本 (2 个破坏性版本)

0.9.0 2024年5月27日
0.8.0 2023年8月28日
0.7.0 2023年3月2日
0.7.0-rc.12023年2月19日

#7 在 #undo

Download history 17/week @ 2024-05-04 12/week @ 2024-05-11 10/week @ 2024-05-18 221/week @ 2024-05-25 47/week @ 2024-06-01 27/week @ 2024-06-08 18/week @ 2024-06-15 28/week @ 2024-06-22 15/week @ 2024-06-29 23/week @ 2024-07-06 12/week @ 2024-07-13 13/week @ 2024-07-20 56/week @ 2024-07-27 15/week @ 2024-08-03 16/week @ 2024-08-10 13/week @ 2024-08-17

每月 102 次下载
用于 2 crates

MIT/Apache

1MB
20K SLoC

git-branchless logo

Git 无分支工作流

(此工具套件与分支 100% 兼容。如果您觉得这很令人困惑，您可以在 此处讨论新的名称。)

Linux build status Windows build status macOS build status
Github Discussions Discord

▼ 跳转到安装 ▼
▼ 跳转到目录 ▼

关于

git-branchless 是一套工具，它以多种方式增强 Git

它 使 Git 更易于使用，无论是新手还是高级用户。例如

它 为高级用户增加了更多灵活性。例如

  • 补丁栈工作流程: 强力支持 Linux 和 Git 项目以及许多大型科技公司使用的 "补丁栈" 工作流程。（这就是 Git "应该" 被使用的方式。）
  • 原型设计和实验工作流程: 通过 "分歧" 开发方式，强烈支持原型设计和实验工作。
  • git sync: 无需检出即可重新合并所有本地提交栈和分支。
  • git move: 在清理旧分支时，能够移动子树而不是 "棍子"，而不会触及工作副本等。
  • 匿名分支: 减少了实验性工作分支的开销。
  • 内存操作：无需检出相关提交即可修改提交图。
  • git next/prev：快速在提交堆栈中跳转提交和分支。
  • git sw -i/--interactive：交互式选择要切换到的提交。

它为大型仓库和单体仓库提供了更快的操作，尤其是在大型科技公司中。示例

  • 参见博客文章 使用 git-move 的闪电般快速变基。
  • 性能测试：在 torvalds/linux（1M+ 提交）和 mozilla/gecko-dev（700k+ 提交）上进行了基准测试。
  • 在内存中操作：默认情况下避免触碰工作副本（这可能减慢 git status 或使构建工件失效）。
  • 稀疏索引：使用针对快速提交和合并操作的自定义稀疏索引实现。
  • 分段变更日志DAG：对提交图进行高效查询，例如在 O(log n) 而不是 O(n) 时间内计算合并基础。
  • 预编译：使用具有良好运行时性能的预编译语言（Rust）编写。
  • 多线程：在适当的情况下将工作分配到多个CPU核心。
  • 据我所知，git-branchless 提供了 Git 工具和 UI 中 最快 的变基实现，原因如上所述。

另请参阅 用户指南 和 设计目标。

目录

演示

修复

撤销几乎所有操作

  • 提交。
  • 修改后的提交。
  • 合并和变基（例如，如果您错误地解决了冲突）。
  • 检出。
  • 分支创建、更新和删除。

为什么不使用 git reflog？

git reflog 是一个用于查看单个引用（如 HEAD）之前位置的工具，可用于撤销操作。但由于它只跟踪单个引用的位置，因此像变基这样的复杂操作可能难以逆向工程。 git undo 在更高的抽象级别操作：您的整个仓库状态。

git reflog 基本上也不能用于撤销某些罕见操作，例如某些分支的创建、更新和删除。有关更多详细信息，请参阅 架构文档。

git undo 无法处理什么？

git undo 函数依赖于 Git 近期版本的某些功能才能正常工作。请参阅兼容性图表。

目前，git undo 无法撤销以下操作。您可以在问题 #10中找到处理这些情况的设计文档。

  • 通过撤销提交并将更改恢复到工作副本来“取消提交”一个提交。
    • 在原始 Git 中，这可以通过 git reset HEAD^ 实现。
    • 在这种情况下，使用自定义的 git uncommit 命令会更好。请参阅问题 #3。
  • 撤销对文件暂存或取消暂存的操作。这由上述问题 #10 跟踪。
  • 撤销到冲突的“中间”位置，使得 git status 显示类似 path/to/file (both modified) 的消息，这样您就可以分别解决该特定冲突。这由上述问题 #10 跟踪。

从根本上讲，git undo 不打算处理对未跟踪文件的更改。

与其他 Git 撤销工具的比较
  • gitjk：需要 shell 别名。只能撤销最近的命令。只能处理一些 Git 操作（例如，不处理变基）。
  • git-extras/git-undo：只能撤销当前 HEAD 上的提交。
  • git-annex undo：只能撤销指定文件或目录的最新更改。
  • thefuck：只能撤销历史 shell 命令。只能处理一些 Git 操作（例如，不处理变基）。

可视化

使用智能日志（git sl）可视化您的提交历史

为什么不使用 git log --graph 呢？

git log --graph 只显示附有分支的提交。如果您喜欢在没有分支的情况下工作，那么 git log --graph 就不会为您工作。

为了支持广泛重写提交图的用户，git sl 还会指出那些被放弃的提交（标记为 rewritten as abcd1234 的提交的后代），它们可以通过 git restack 自动修复，或者手动处理。

操作

无惧地编辑您的提交图

为什么不使用 git rebase --interactive 呢？

使用 git rebase --interactive 进行交互式变基完全受支持，但它有一些缺点。

  • git rebase --interactive 只能修复线性提交系列，而不是树结构。如果你修改了一个具有多个子提交的提交，那么你必须确保适当地重新变基所有其他子提交。
  • 在开始变基之前，你必须制定一个行动计划。对于某些用例，一次操作一个提交可能比一次性操作整个提交系列更容易。

当你使用 git rebase --interactive 与 git-branchless 一起时，如果你放弃任何提交，你会被提示修复你的提交图。

安装

请参阅 https://github.com/arxanas/git-branchless/wiki/Installation。

简而言之：检查适用于您的系统的存储库中的软件包或运行 cargo install --locked git-branchless。安装后，在您的存储库中运行 git branchless init。

状态

git-branchless 目前处于 alpha 版本。准备好应对可能发生的变化，因为一些工作流程和架构可能在将来发生变化。相信没有重大错误，但它还没有经过全面的实战测试。你可以在 问题追踪器 中查看已知问题。

git-branchless 遵循 语义版本化。新的 0.x.y 版本，以及达到 1.0.0 后的新主要版本，可能会以向后不兼容的方式更改磁盘格式。

要获取新版本的提醒，请选择页面顶部的 Github 通知菜单中的“Watch”>“Custom”>“Releases”。或者使用 GitPunch 通过电子邮件发送通知。

这个领域正在开发许多有希望的工具。有关更多信息，请参阅 相关工具。

贡献

感谢您对贡献的兴趣！如果您愿意，我很乐意安排一次电话会议来 帮助您入门。

对于代码贡献，请参阅 操作手册 了解如何设置开发工作流程，以及 编码指南。您还可能想阅读 架构 文档。

对于文档贡献，请参阅 Wiki 风格指南。

贡献者应遵守 行为准则。

lib.rs:

在提供的每个提交上运行用户提供的命令。这对于使用缓存、并行化、树外执行等对当前堆栈中的所有提交进行检查很有用。

依赖关系

~76MB
~1.5M SLoC