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

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

3. 项目协作案例示例

假设我们有一个三人小组做《坦克大战》游戏项目：

• 小策（策划）： 关卡设计、玩法文档
• 小美（美术）： 坦克素材、地图贴图
• 小程（程序）： 代码、功能实现

他们分工协作的流程如下：

1. 创建仓库： 小程创建项目仓库（Git 仓库 = 游戏资料大箱子），包含 /code（代码）、/assets（美术资源）、/docs（策划文档）。
2. 独立开发： 每个人在各自的文件夹开发，互不干扰。
   • 小策写玩法文档 → 提交到 docs
   • 小美打磨素材 → 提交到 art
   • 小程写移动逻辑 → 提交到 code
3. 复杂场景： 如果团队扩大，比如程序组有 3 人共同开发 branch-code，可以通过更新代码分支、拉取代码分支、合并代码分支等操作来完成。

为了避免抢文件，通常采用分支策略：

这样即使发生冲突（如两位美术同时修改图片），Git 也能通过分支管理有效隔离风险。

二、Git 仓库结构

1. 本地仓库

当你从远程克隆项目或在本地 git init 创建项目时，就会生成一个本地仓库。

本地仓库 = 你自己桌面上的草稿本

你可以随意改、写乱、翻以前的内容，谁也不会受影响。等你满意后再把结果拿去'共享'——那就是 push 到远程。

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

本地仓库能做的事

1. 随时 commit，保存历史： 不需要等到完美再提交，只要改动完成一小步就能保存。每次都是一张'时光快照'，崩了直接回滚。
2. 无限分支，安全实验： 分支是从主项目复制出来的实验环境。无论试验多疯，不会影响主项目，随时可合并或放弃。
3. 离线可用： 高铁、断网环境下，依然可以查看历史、建分支、commit 保存快照。
4. 推送前自查： 先在本地打磨，测试通过后再 push，保证远程永远是靠谱版本。

2. 远程仓库

远程仓库 = 把你的代码/文件存在网上，而不是只放在你电脑里。

一般靠谱的队友会把自己深思熟虑的工作成果上传到远程仓库。这样做最重要的作用是：换电脑也能随时拿到项目、队友能随时一起修改、本地电脑坏了文件也不会丢失。

远程仓库能做的事

1. Push（推送）： 把你电脑里的成果上传到远程仓库，让别人看到。适用于完成功能、修 bug 后同步进度。
2. Pull（拉取）： 把他人更新下载并合并到本地，保持最新进度。适用于队友开发完新模块或有冲突修复时。
3. 权限管理： 设置公开/私有、谁能看、谁能写、谁只能读。

为什么要有远程仓库？

1. 多人协作的中心版本库： 约定以远程仓库为'唯一权威版本'，大家从远程拉最新 → 本地改 → 传回远程，形成闭环。
2. 项目的安全备份： 异地备份，RAID 磁盘阵列，防止本地硬盘损坏导致数据丢失。
3. 多设备同步枢纽： 在公司写到一半 push，回家 pull，立刻接着写。
4. 自动化触发点： 很多团队约定'有人 push 到远程，就自动触发测试、构建或部署'。

常见的 Git 远程仓库平台

三、Git 操作详解

理解了作用与仓库结构，下面通过实例讲解具体操作步骤。还是沿用之前的《坦克大战》六人组场景。

1. Git 基础操作

① git init 操作

程序员小程在自己的文件夹里创建项目，打开终端输入：

git init

这会让文件夹变成 Git 仓库，拥有属于自己的本地仓库。

② git add 和 git commit

回顾三层区域：工作区 → 暂存区 → 本地仓库。

git add      # 把改动从'工作区'放进'暂存区'
git commit   # 把暂存区的内容打包，存进'本地仓库'

流程示意： 你改文件 → git add → git commit

add 命令示例：

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

commit 命令示例：

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

一个 commit 会包含当前暂存区所有文件的版本、提交人信息、时间及说明。以后你可以回到这个 commit 对比差异或回滚。

暂存区的作用： 可以先把'确定的部分'放进暂存区，不确定的先留着。比如 move.py 改完了确定没问题，ai.py 还在乱试，可以先 add move.py 并提交，ai.py 继续改。

③ git log 操作

git log 用来查看提交历史（commit 记录），就像时间轴。

git log

你会看到类似以下的记录：

commit 45bb3c4f4d...
Author: 小程 <cheng@tank.com>
Date: 2024-01-22 16:41
"完成 art，code，doc 初始文件构造"

④ git remote add origin 操作

将本地仓库与远程仓库（如 GitHub、Gitee）关联。

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

例如：

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

此后，所有的 push 和 pull 操作都会默认对这个远程仓库进行。

⑤ git push 操作

将本地仓库的更改上传到远程仓库。

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

如果是第一次推送，且分支未关联，可以用：

git push -u origin main

其中 -u 表示设置 upstream 关联，以后直接用 git push 即可。

⑥ git clone 操作

其他人要参与项目，需将远程仓库克隆到本地。

git clone <远程仓库地址>

执行完后，电脑里多了一个带完整 Git 历史的文件夹。这和下载 ZIP 压缩包不同，clone 下来的可以直接进行版本管理。

2. Git 分支与同步操作

① git pull 操作

如果队友更新了项目，你不需要重新 clone，直接通过 git pull 更新即可。

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

git pull 实际发生了两件事：

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

所以 pull = fetch + merge。

流程示意：

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

② git fetch 操作

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

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

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

小白可以这么想： 把远程仓库想成'总店账本'，本地仓库是你手里的'分店账本'。git fetch 就像去总店复印了一份最新账本带回店里，但你还没用它去改自己本地的账本。

③ git merge 操作

（注：后续章节将继续深入讲解分支合并策略及冲突解决细节，此处重点在于理解 Pull 的底层逻辑。）

通过理解 fetch 和 merge 的分离，你可以更灵活地控制代码同步节奏，确保本地工作不受远程变动意外影响。