Git 核心原理与团队协作实战指南

这就是现实世界的多人文件地狱。而 Git 的出现，就是为了结束混乱。

用 Git，每个人都能同时做事

你可以把 Git 想象成一本大型练习册，每个人都可以同时写自己的那一页，不会互相抢笔。

• 小王写第一章
• 你改目录
• 小李润色结尾
• Git 自动把大家写的部分合起来

就像几个人一起拼拼图，不用挤一个位置。没有喊话、没有抢文件、没有版本混乱。

🔥 就算冲突了，Git 也能帮你处理

有时候不可能完全不重叠——你改了第三段，小李也改了第三段。Git 不会让你们打架，它会标出分歧点，让你决定选哪个。它不是替你做裁判，而是把分歧摆在你面前。

一句话总结：你做你的，我做我的；最后 Git 把结果合成一个版本，历史都存着。

3. 团队协作案例示例

以三人小组做《坦克大战》游戏项目为例：

他们分工协作：

1. 小程创建项目仓库（Git 仓库 = 游戏资料大箱子），包含文件夹：/code, /assets, /docs。
2. 各自开发：小策写文档，小美画素材，小程写代码。互不干扰。
3. 提交合并：完成一部分后提交，拉取分支和提交分支即可。

更复杂的情况下，比如程序组多人共同开发同一模块，可以通过更新代码分支、拉取代码分支、添加代码分支、合并代码分支等操作来完成。这将在后续章节详细讲解。

二、Git 仓库

1. 本地仓库

什么是本地仓库？

当你从远程仓库克隆项目到电脑，或自己在本地 git init 创建一个项目时，就会生成一个本地仓库。它就像一个记录你所有修改历史的私人工作区，不联网也能使用的开发空间。

本地仓库 = 你自己桌面上的草稿本 你可以改、可以写乱、可以翻以前的内容，谁也不会受影响。等你满意后再把结果拿去'共享'——那就是 push 到远程。

本地仓库实际上包含三个区域

本地仓库能做的事

1. 随时 commit，保存每一次改动历史 不需要等到完美再提交，只要改动完成一小步就能保存。每一次都是一张'时光快照'，想回滚随时回。

2. 可以无限分支，做实验安全无风险 分支是本地仓库最大自由度。多出来的分支，你可以看作从 copy 一份项目文件出来用于你的项目实验。

   main（稳定版）
   ├─ try-ai-test ← 测 AI 敌人看是否好玩
   ├─ ui-redesign ← 改坦克 UI 但怕翻车？
   └─ crazy-physics ← 胡搞弹道轨迹也不怕
   

   无论试验多疯，不会影响主项目，也不会影响队友，随时可合并 or 放弃。

3. 本地仓库可以脱离网络使用 坐高铁、去咖啡馆断网、飞机上开发，你依然可以查看版本历史、建分支、commit 多次保存快照。

4. 推送前可以自查，不会破坏主项目 直接在云端写代码风险很大。Git 不允许直接改远程，而是要求先在本地完成修改。你在本地打磨 → 测试通过 → push。这样保证提交到远程的永远是靠谱版本。

2. 远程仓库

什么是远程仓库？

远程仓库就是把你的代码/文件存在网上，而不是只放在你电脑里。它可以存储你每次提交的信息，并且队友也能通过远程仓库即时的看见你提交的信息。

远程仓库的作用：

• 换电脑也能随时拿到项目文件
• 队友能随时一起修改项目文件
• 本地电脑坏了文件也不会受到任何损失

远程仓库能做的事

1. 本地代码推送到远程仓库 (push) 你在本地写代码 → commit 保存 → 想共享给队友。这时执行 push：把你电脑里的成果上传到远程仓库，让别人也能看到。

2. 从远程拉取最新代码到本地 (pull) 当别人推送了更新，而你本地还是旧版本，你需要 pull：把他人更新下载并合并到本地，让你保持最新进度。

3. 支持权限管理 你可以设置公开还是私有？谁能看？谁能 push？谁只能 read-only？

为什么要有远程仓库？

1. 做多人协作的「中心版本库」 约定：以远程仓库为'唯一权威版本'。大家从远程拉最新 → 在本地改 → 改完再推回远程。

2. 做项目的「安全备份」 只放在本地会怎样？电脑坏了、硬盘挂了、被偷了 → 项目没了。而远程仓库在云端服务器上，异地备份，RAID 磁盘阵列，运维团队守着。你本地炸了，只要远程在，一切还在。

3. 做多设备之间的「同步枢纽」 在公司写到一半 → push；回家 pull 一下 → 立刻接着写。远程仓库就是你的'云端中转站'。

4. 做「权限控制」和「审计记录」 远程仓库一般都在平台上托管，比如 GitHub、Gitee、GitLab.com、Bitbucket。这些平台会提供谁能访问、谁能写、谁在什么时候提交了什么东西。

5. 驱动自动化 很多团队会约定：'只要有人 push 到远程仓库，就自动触发一件事。'比如自动跑一遍测试，自动构建、自动部署到测试环境 / 线上，或者自动做代码检查。

常见的 Git 远程仓库平台有哪些？

三、Git 操作详解

现在大家理解了 Git 的主要作用，本地仓库，远程仓库，下面通过一个简单的项目实例来讲解一下 Git 的详细操作步骤。

1. Git 基础操作

① git init 操作

程序员在自己的文件夹里创建了一个项目文件，打开终端 / Git Bash，选中这个项目的文件夹，并输入：

git init

让文件夹变成 Git 仓库。这时候就有属于自己的本地仓库了。

② git add 操作和 git commit

创好本地仓库后，回顾一下本地仓库的三层区域：

git add // 把改动从'工作区'放进'暂存区'，为下一次 commit 做准备
git commit // 把暂存区的内容打包，存进'本地仓库'变成一个历史版本

简化流程就是：你改文件 → git add → git commit

git add 命令示例：

git add main.py # 把 main.py 的修改放入暂存区
git add assets/ # 把 assets 目录下所有变化加入暂存区
git add . # 把当前目录所有变更都加入暂存区

git commit 命令示例：

git commit -m "实现坦克移动和开火功能"
git commit -m "更新美术资源：红色坦克皮肤"
git commit -m "补充文档：第一关敌人刷怪规则"

一个 commit 会包含当前暂存区所有文件的版本、提交人信息、提交时间、提交说明。以后你可以回到这个 commit，看那时候项目长什么样，对比当时和现在的差别出了问题，可以回滚/对比排查。

暂存区的作用： 可以先把'确定的部分'放进暂存区，不确定的先留着。

比如你还在试验一半：

• /code/move.py 已经改完了，确定没问题 ✅
• /code/ai.py 还在乱试，根本写不完 ❌

你可以：

git add code/move.py # 这部分先纳入提交计划
# ai.py 先别管
git commit -m "完成坦克移动重构"
# ai.py 继续改，改爽再说

add = 我对这些改动'有信心了，准备提交' 工作区未 add 的内容 = '还在玩，还没想好，先别进历史'。

③ git log 操作

git log 用来查看提交历史（commit 记录）。它就像时间轴，你能看到项目从过去到现在经历了什么改动。

执行：

git log

你就可以看见记录：

commit 45bb3c4f4d...
Author: 小程 <[email protected]>
Date: 2024-01-22 16:41
"完成 art，code，doc 初始文件构造"

④ git remote add origin 操作

本地创建了一个 Git 仓库，并且完成了第一次提交后，想要把这个本地仓库与远程仓库关联起来。通过执行 git remote add origin 命令，就可以将本地仓库与远程仓库绑定。

命令格式：

git remote add origin <远程仓库地址>

示例：

git remote add origin https://github.com/your-team/tank-battle-game.git

通过这个命令，本地仓库与远程仓库就建立了关联。此后，所有的 git push 和 git pull 操作都会默认对这个远程仓库进行。

⑤ git push 操作

连接远程仓库后，小程想将本地仓库的内容（提交）上传到远程仓库，这时候就要用到 git push。

命令格式：

git push <远程仓库名> <本地分支名>:<远程分支名>

如果是第一次推送，并且本地和远程仓库的分支还没有关联，可以用：

git push -u origin main

其中 -u 表示设置 upstream 关联，也就是说以后就可以直接用 git push 不需要再指定远程仓库和分支。

到此为止：建立好了本地仓库，并把仓库文件上传到远程仓库，其他队友，就可以通过远程仓库来拉取或者克隆项目了。

下面是建立仓库的流程：

1. 你电脑里先有项目文件
2. git init（让文件夹变成 Git 仓库）
3. git add + git commit
4. 再去平台创建远程仓库
5. git remote add origin <远程仓库地址>
6. git push 上传到远程

⑥ git clone 操作

仓库项目初始文件已建在 GitHub / GitLab / Gitee。每个人打开终端 / Git Bash，选一个放项目的文件夹：

git clone <远程仓库地址>
# 比如：
git clone https://github.com/your-team/tank-battle-game.git

执行完后，他们的电脑里就多了一个文件夹，这个文件夹就是各自的本地仓库，接下来所有改动都在这里发生。这一步叫：clone（克隆）。

clone 可以看作：把远程仓库完整'拷贝一份'到自己电脑上，变成本地仓库。但这和'下载 ZIP 压缩包'相比，有两个本质区别：

• zip 只是一堆文件，没 Git 历史、不能 commit、不能 push
• clone 下来的，是一个带完整 Git 历史、可以继续版本管理的仓库

2. Git 分支操作

① git pull 操作

项目成员通过 git clone 操作在本地得到了大家共同的项目，如果后续有成员通过 git push 更新了这个项目，那我们还需要进行 git clone 来更新项目吗？不用，我们直接通过 git pull 命令来执行就可以了。

git pull = 从远程仓库拉取最新更新，并自动合并到你的本地仓库。

git pull 实际发生了两件事

git pull 其实是两个命令的合体：

git fetch（从远程把更新'拉下来'） + git merge（把更新合并进你的当前分支）

所以 pull = fetch + merge

流程示意：

远程仓库（远程最新版本）
↓ fetch
本地仓库（拿到更新但还没合并）
↓ merge
你的当前分支（更新后的最终版本）

你只执行一条 pull，它内部自动帮你完成这两步。

假设队友小红通过以下操作推了新的坦克皮肤：

git add assets/tank.png
git commit -m "新增蓝色坦克皮肤"
git push

你只需输入：

git pull

本地立刻出现：

/assets/tank.png ✔

② git fetch 操作

git fetch：只'拿'，不'动'

一句话解释：

git fetch：从远程仓库把最新的提交记录拉到本地，但不改动你当前的代码文件**。

也就是说：

• 它会更新 origin/main、origin/dev 等远程分支的指针
• 但它不会去改你现在正在用的分支（比如本地 main）

小白可以这么想：把远程仓库想成'总店账本'，本地仓库是你手里的'分店账本'。

• git fetch 就像：去总店复印了一份最新账本带回店里，但你还没用它去改自己本地的账本。

你只是知道了'总店现在是什么样'，但你自己的账本还停留在原来的状态。

实际会发生什么？

执行：

git fetch # 或者更明确一点：git fetch origin

Git 会做几件事：

• 从远程仓库把最新提交记录下载下来
• 更新本地的'远程跟踪分支'，比如：origin/main、origin/dev、origin/feature-xxx
• 不改变：你的当前分支（如本地 main 的内容保持不变）、你的工作区文件（不会突然多/少东西）

你可以理解为：

'先把远程的最新情况同步到本地的数据库里，但先不动我的工作区。'

查看 fetch 之后的情况，你可以用：

git log --oneline --graph --all

看到：

• 本地 main 在某个位置
• origin/main 可能已经往前走了几步（多了几次提交）

这时候你就知道：

'远程已经更新，但我本地还没跟上。'

③ git merge 操作

掌握以上基础命令，你就能高效管理代码历史，避免冲突与数据丢失。在实际开发中，合理运用分支策略，能让团队协作更加顺畅。