Git / GitHub · 深度入门手册

分类：协作与仿真 ｜难度：★★☆ 进阶｜编号：git

一、这是什么（一句话用途）

版本控制与协作，管理代码/文档历史，多人建模队不丢稿、可回滚。

二、核心定位

分布式仓库，commit 记录快照，branch 并行，push/pull 同步，GitHub 托管远程。

三、核心原理剖析

Git 是现代软件协作的基石，对建模队同样关键：三人同时改模型代码、论文脚本、数据清洗程序时，Git 能记录每一次改动（commit）的快照与作者，出问题可精确回滚，并行开发用分支（branch）互不干扰，再合并（merge）到一起。它"分布式"的特性意味着每个成员本地都有完整历史，断网也能提交，联网后再同步远程（GitHub/GitLab）。理解 Git 不是记命令，而是理解它的"三棵树"模型（工作区/暂存区/版本库）与"内容寻址"的对象存储——这能解释为什么 Git 既快又不会丢历史。

四、底层机制与推导

三棵树与提交：Git 维护三个状态——工作区（working tree，你编辑的文件）、暂存区（index/stage，下次提交的内容快照）、版本库（repository，已提交历史）。add 把工作区改动计入暂存区，commit 把暂存区固化为一个 commit 对象。

内容寻址存储（SHA-1）：Git 把每个文件内容哈希为 40 位十六进制 blob 对象（如 e69de29...），目录结构存为 tree 对象，commit 指向 tree 并含父指针、作者、消息。因此"相同内容只存一份"（去重），且任何篡改都会改变哈希——保证历史不可伪造。

分支即指针：分支只是一个指向某 commit 的轻量指针（文件里存 41 字节的 SHA-1）。git branch dev 创建指针，git checkout dev 移动 HEAD；合并时若两分支从同一祖先分叉，Git 做三方合并（common ancestor + 两分支 tip）自动融合，冲突处标记 <<<<<<< 供人解决。

增量存储：为省空间，Git 对 blob 做 delta 压缩（zlib + 相似对象差量），故百万次提交也不会线性膨胀存储。

五、上手步骤

git init / clone 仓库
写代码后 git add
git commit 提交快照
git branch 开分支
git push 推到远程

六、关键命令 / 语法 / 界面要点

git init
 git add .
 git commit -m "初版模型"
 git branch dev && git checkout dev
 git remote add origin <url>; git push -u origin main

七、最小可跑示例

本地建仓库，commit 三次模型版本；push 到 GitHub 与队友共享。

八、学习资源 / 去哪学

git-scm.com；GitHub/GitLab/Gitee；图形客户端 SourceTree/Fork；教程 Pro Git。

九、常见坑（避坑清单）

先 commit 再 push
大文件用 .gitignore/ LFS
冲突要手动解决
别把密钥提交进去

十、怎么算用好了

git log 看历史；status 看改动；分支隔离实验不破坏主线。

十一、能跑哪些建模算法

管理：所有代码/手册/PPT 版本；配合 Overleaf/Notion 做协作。

本手册由「工具入门手册生成器」自动产出（深度版），与算法深度手册同套体系。

实战案例

Git 团队协作实战

场景：三人写同一篇论文，频繁改动，需避免互相覆盖。
任务：用 Git 分支 + 合并管理论文版本。

完整代码（bash）

# 初始化与首次提交
git init
git add . && git commit -m "初稿框架"

# 每人开分支开发
git checkout -b feat/model   # 建模手
git checkout -b feat/write   # 写作手

# 写完后合并
git checkout main
git merge feat/model         # 若无冲突自动合并
git merge feat/write         # 冲突时手动解决再 commit

# 推送远程备份
git remote add origin <url>
git push -u origin main

运行效果

$ git log --oneline
a1b2c3 合并写作手分支
d4e5f6 合并建模手分支
7890ab 初稿框架
分支开发互不干扰，合并记录可追溯每个人的贡献。