0 写在前面¶

约 1294 个字预计阅读时间 4 分钟

为什么会有这篇文章¶

在大学，我们曾经尝试过通过 GitHub 来进行代码的版本管理和协作。但是，当时懒惰，因此一直在使用 GitHub Desktop；对 git 的真正使用也只是限于 add, commit, push, pull 等简单的操作，也从来没学会过如何处理 conflict。

不过，在实习以及现在正式工作之后，面对复杂的代码和各种多人协作的场景，我不得不稍微仔细学习一下 git。为了更好地理解 git 的原理，我打算尝试自己实现一个简化版的 git，并尝试将过程分享出来，从而让大家更好地理解 git 的原理。

我 Google 了 DIY git，找到了一些参考资料。这些参考资料能够在千行以内实现一个简化版的 git，这让我认为这个目标是可行的。不过，我比较在意的一些指令在这些参考资料中并没有实现，因此实现这些指令是我的一个挑战性目标。

我的学习过程中参考的资料

我部分代码的实现，以及本文的部分文段，可能来自于上述资料。除此之外的参考，我会在文中单独标注。

我使用 Python 和 typer 来实现这个项目，因为这也是我工作中会使用到的东西，我希望在这个过程中也能锻炼这方面的能力。

我希望本文能够像一个「实验指导」一样，在每个章节中为大家介绍尽可能全面的基础知识，陈述章节的目标，最后分享我自己的代码。

如果您也有兴趣也自己 DIY 一个 git，我希望本文能够给您提供所需的知识，引导您完成这个过程。同时我也希望您能将您的实现与我的代码进行对比，从而帮我指出我的代码中可以改进的地方，或者可能存在的错误。

（如果您这样做了，请考虑在您的实现中附上本文的链接，感谢~）

如果您没有兴趣或者时间自己实现一个 git，我也希望本文能够像一个「源码剖析」一样，给您解释我的实现，从而帮助您高效地理解 git 的原理。也希望您能在这个过程中帮我发现问题。

Warning

同时，由于这是我的学习笔记，因此我预期我的实现和设计一定会有一些错误或者不妥当的地方，因此我有可能在学习和实现的过程中对代码做重构或者修改。这些修改能够在本文中得以修正，因此仓库中的提交记录和文章内容可能有所区别。此时应以文章内容为准。

我不会尝试实现 git 的全部功能，我也不一定会和 git 的行为完全一致。

本文的核心目标仍然是学习 git，因此实现哪些功能取决于我想学习哪些功能以及它们背后的原理。

我预设读者具备以下能力，因为这是我的状态：

会搜索，或者会用 ChatGPT
对命令行有基本的了解。我使用的是 macOS 和 ubuntu，因此我会使用 macOS 的终端来展示命令行的效果。如果您使用的是 Windows，我的部分命令可能无法在您的终端中运行，此时需要您回到第 1 条；另外强烈建议使用 WSL！
对 git 的最基本使用有了解，例如 add, commit, push, pull 等
掌握至少一门编程语言，因为这是看懂代码的基础。我也不太会 Python，所以我认为会的语言不是 Python 也没关系

对于上述预设以外的知识，我会在文章中进行解释。

在本文中，我会使用各种不同的 admonitions 来标注一些内容。它们表示如下含义：

摘要

文章或者某一部分的摘要

提示

一些基础知识，但是可能不是所有人都知道

警告

已知可能出现的问题，或者与 git 的行为有明显差异的地方（但我可能不会完全说明比 git 少实现了哪些功能）

我的代码

指示我的代码在哪里

额外信息

一些我认为有必要陈述的信息

次要内容

一些可能会有人感兴趣但不重要的内容

参考资料

用于标明一些参考或出处

我并不一定会将所有符合上述描述的内容都用 admonitions 标注出来。如果它们非常短，我可能会在文中直接说明；而如果它们非常长，我可能会将它们放在一个单独的小节中。

有用的话请给我个赞和 star =>

快来跟我聊天~