开源项目Git贡献全流程拆解(3)Git核心概念精讲:仓库、提交、分支与工作流
很多人学Git,看了一堆教程,背了一堆命令,真到开源项目里提交代码还是发怵。尤其是从“自己建个仓库随便玩玩”过渡到“给别人的项目贡献代码”,中间那道坎一直过不去。问题出在哪?我观察下来,绝大多数人是卡在了概念层面——不是因为Git命令难记,而是因为不知道每条命令背后到底在操作什么。
这篇是开源项目Git贡献全流程拆解的第三篇,重点把仓库、提交、分支、工作流这四个核心概念掰开揉碎讲清楚。这四个概念是后续一切操作的地基:你在开源项目里做的每一个操作,本质上都是在跟这四个东西打交道。理解了它们,后面讲fork、PR、冲突解决、代码审查,你才能一马平川。
1. 仓库:不是你看到的文件夹,而是三层区域的协作
先纠正一个特别常见的误区:很多人以为仓库就是那个能看到的项目文件夹。其实不对。git init之后,项目文件夹里多了一个隐藏的.git目录,那个.git目录才是真正的仓库本体,你肉眼看到的那些源代码文件,只是仓库在工作区里的一层“投影”。
1.1 仓库的三大区域:工作区、暂存区、版本库
理解仓库,关键是理解三个区域的分工。
-
工作区(Working Directory):就是你在编辑器里打开、修改的那些文件。你改代码、删文件、新建文件,操作的都是工作区。这是你直接接触的区域,也是唯一一个你能随心所欲改来改去而不会把仓库搞坏的区域。
-
暂存区(Index / Staging Area):Git里最容易被忽略、但恰恰是最精妙的设计。可以把它理解成一个“候车区”:你告诉Git“这三个文件我改完了,准备提交”,Git就把它们的快照(其实是文件内容)放入暂存区。为什么需要暂存区?因为一次提交应该是一个完整的逻辑单元,比如修复一个bug可能涉及前端1个文件、后端2个文件、测试1个文件,你希望这4个文件作为一个整体提交。但问题是你改代码不是一次性改完的,可能前端先改完,后端还没动。这时候你先把改完的前端文件
git add到暂存区,等4个文件都改完、都add进去,再一次git commit,就形成了一个完整且干净的提交。没有暂存区的话,你要么把所有改动一股脑提交(夹杂无关文件),要么用一堆git add -p交互式操作去挑选内容,体验会很割裂。 -
版本库(Repository / .git目录):这才是仓库的核心。它保存着你所有的提交记录、所有历史版本、所有分支指针。工作区和暂存区可以被随意清空、重建,版本库里的对象一旦提交,就构成了项目的完整历史。
1.2 .git目录里到底存了什么
打开.git目录,你会看到一堆文件和文件夹,第一次看会觉得很唬人,但核心就几个:
objects/:Git对象数据库。提交、文件快照(blob对象)、目录树(tree对象)都以压缩后的二进制形式存在这里。这是Git真正存数据的地方。refs/:引用目录。里面存的是分支指针、标签指针。打开refs/heads/master,里面就是一个SHA-1哈希值,指向某一次提交。HEAD:一个文件,里面存的是当前分支的引用,比如ref: refs/heads/master。它告诉你“你现在在哪个分支上”。index:暂存区的内容就是存在这个文件里。config:仓库级别的配置文件。
注意:这些你不需要全部记住,但知道它存在、知道它大致存什么,能帮你在遇到“为什么我文件删了但仓库还那么大”“为什么Git知道我在哪个分支”这类问题时,不慌。
1.3 从“新建一个开源项目仓库”看三层区域协作
假设你在本地初始化一个仓库:
bash复制git init my-project
cd my-project
echo "# My Project" > README.md
git status
这个时候git status会告诉你README.md是“Untracked files”(未跟踪文件),意思是Git看到了这个文件,但还没决定要管它。你执行:
bash复制git add README.md
git status
文件状态变成“Changes to be committed”(已暂存),说明文件已经进入暂存区。接着:
bash复制git commit -m "Initial commit"
Git会把暂存区的内容打包成一个提交对象,写入objects/,然后更新refs/heads/master指向这个新提交,同时清空暂存区。
这三步操作,就是三层区域协作最典型、最完整的循环。几乎所有Git操作,都可以映射到这三层区域的某个动作上。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 提交:从改动到历史记录的完整路径
提交(commit)是Git里最核心、也最容易被低估的概念。很多人把git commit当成“保存文件”的加强版——点一下,代码就存上去了。如果只是这种理解,那你后面读历史、写提交信息、处理冲突时都会很痛苦。
2.1 提交对象的内部结构:一次提交到底存了什么
在你执行git commit的那一刻,Git做了几件事:
- 把暂存区里的文件内容生成blob对象,存在
objects/里。 - 根据目录结构生成tree对象(记录了哪个文件在哪个目录、权限是什么、对应哪个blob)。
- 创建一个commit对象,这个对象里包含:
- tree对象的SHA:指向当前项目的目录快照。
- parent的SHA:指向父提交。普通提交有一个父提交;合并提交会有两个甚至多个父提交;根提交(仓库的第一次提交)没有父提交。
- 作者信息(Author):谁写的这段代码。
- 提交者信息(Committer):谁执行了提交。这俩在开源场景下经常不同,比如你给别人项目提PR,作者是你,提交者可能是项目维护者(通过rebase或merge方式合入后)。
- 提交信息(Commit Message):你写的
-m "xxx"内容。 - 时间戳。
