枯木逢春犹再发，人无两度再少年。

导航

• 0 前言
• 1 基本概念
  • 1.1 工作区、暂存区、版本库（流程节点）
  • 1.2 初始化、添加、提交、贮藏（本地操作）
  • 1.3 获取、拉取、推送、克隆（远端操作）
  • 1.4 分支、检出、重置、存档、标签（支线操作）
  • 1.5 合并、重基（合并操作）
• 2 杂七杂八

0、前言

Git 是一个开源的分布式版本管理系统，是 Torvalds 为了更好地管理 Linux 内核开发而创立的。它可以帮你记录每一次代码变化，并且可以随时回到过去的任何版本。【注：相当于是给项目代码的生命周期开了一个时光隧道，以方便开发人员随时回到过去标记好的位置状态。】

1、基本概念

1.1、工作区、暂存区、版本库（流程节点）

• 工作区：就是项目目录、工作目录，你需要在这里进行文件的创建、修改和删除操作。
• 暂存区：可以理解为在工作区进行文件更改操作之前的工作区副本快照，如此一来，之后在工作区进行的每次修改就都有了参照对象。例如，执行命令 git add . 则代表将工作区的文件与暂存区的副本快照进行差异对比以形成补丁包，然后再将暂存区与工作区的文件进行同步以形成新的工作区快照，以供下一次的 add 进行参考使用。【注：add 之前的文件又叫做未暂存文件，add 之后的文件又叫做已暂存文件。】
• 版本库：暂存区产生的补丁包在通过执行提交命令 git commit -m "zhushi" 之后便正式进入到了版本库中，版本库中存放着历史提交的所有补丁包，这些补丁包的存在确保了项目拥有了一个完整的历史修改记录。

注：以上关于暂存区和版本库的描述仅为个人理解，理解不当之处请自行甄别。

1.2、初始化、添加、提交、贮藏（本地操作）

#（0）基础配置【注：git 提交时要求一定要标识当前提交者的身份，否则不允许提交。】
git config --global user.name "你的名字" #任意名字
git config --global user.email "你的邮箱" #任意邮箱
git config --list #查看 git 所有配置项


#（1）初始化：为当前目录构造 .git 目录结构
git init .


#（2）添加：将指定的文件/目录与暂存区的快照进行差异对比，以形成差异补丁包
git add .
git add test.txt


#（3）提交：将 add 产生的补丁包提交到版本库中。
git commit -m "注释说明"


#（4）状态：查看当前工作处于一种什么样的状态。例如，哪些文件修改了但未 add（未暂存文件），哪些文件 add 了但未 commit（已暂存文件）。
git status


#（5）历史：查看代码被修改之后提交过的历史记录。
git log #描述详细的历史记录，但不易于查看
git log --oneline --graph --all #描述简洁且带图表的历史记录


#（6）贮藏：将已更改但未提交的文件都保存起来，等日后自己有时间了再拿出来继续使用。
git stash #保存，但仅保存之前已跟踪的文件，新添加进来的文件不会被保存。如需将新添加的文件也保存进来，需添加 -u 参数。
git stash list #列出保存的项目
git stash pop #恢复

1.3、获取、拉取、推送、克隆（远端操作）

#（0）基础配置【注：远端操作时必须指定远端仓库的位置，以便拉取/推送操作的进行。】
git remote add origin https://github.com/user/repo.git #添加远端仓库
git remote show #查看已配置的远端仓库

#####登录认证相关步骤，请看杂七杂八部分的内容，此处略过...#####

#（1）获取：拉取远程代码到本地的远程分支中，并不与本地主线分支合并。
git fetch 

git branch -r #查看本地拉取下来的远程仓库的分支
git status origin/main #查看本地的远程仓库的状态
git log origin/main #查看本地的远程仓库的日志
git merge origin/main #将拉取下来的本地远程仓库与本地仓库进行合并


#（2）拉取：拉取远程代码到本地的远程分支中，并与本地主线分支合并。
git pull #从远端拉取当前分支，并于本地的当前分支合并
git pull origin main #从远端拉取 main 分支，并于本地的 main 分支合并。哪怕当前分支是 dev 分支，依旧不影响对 main 分支进行更新。


#（3）推送：推送本地代码到远程仓库并合并
git push
git push origin main


#（4）克隆：复制一份远程仓库的内容到本地
git clone https://github.com/user/repo.git

1.4、分支、检出、重置、存档、标签（支线操作）

#（1）分支：从当前的主线任务中分离出来另外一条支线，此时主线和支线的文件环境完全相同，同时两者各自的工作动作也不会影响到对方。此后，若支线的实验工作成功了，主线便可以合并支线直接收获支线的劳动成果，若失败了删除支线即可。
git branch #查看分支
git branch dev #创建 dev 分支
git switch dev #切换到 dev 分支


#（2）检出：直接跳转到指定的 某个分支、某个提交、某个标签 的环境，方便随时查阅当时的现场情况。【注：仿佛穿越过去一样】
git checkout main #跳转到分支
git checkout 8fc7720e4bc5304e1550a7f120e4f02c203d4f07 #跳转到提交
git checkout v1.0.0 #跳转到标签


#（3）重置：重置工作区的 HEAD 指向、以及暂存区的状态、以及工作区的内容。
git reset HEAD~1 #混合重置：撤销 commit、保留代码、取消暂存（回到“未暂存区”）
git reset --soft HEAD~1 #软重置：撤销 commit、保留暂存状态
git reset --hard HEAD~1 #硬重置：撤销 commit、删除暂存、删除工作区改动


#（4）存档：导出某个版本的代码（但不包含 Git 历史），相当于是检出到某个位置，然后将当前位置环境中的文件全部压缩到一个包中。
git archive -o project.zip main


#（5）标签：给某个 commit 打一个“名字”，方便未来定位或记忆这个特殊的节点状态
git tag v1.0.0 #给当前 HEAD 位置（即最近的 commit）打一个标签
git tag tag_name commit #给指定 commit 打一个标签
git push origin --tags #推送 tag 标签【注意：git push 默认并不会推送标签记录，标签记录需要像这样去提交。】

注：关于重置三种状态的区别。

1.5、合并、重基（合并操作）

#（1）合并：把两个分支“合并在一起”，并保留分叉结构，能清晰看到分支是怎么合并的，历史记录清晰。
git switch main
git merge dev

#（2）重基：把你的提交“搬到另一个分支后面”，使得提交历史会比较整洁，但会重写提交历史，无法看清分支是怎么合并的。【注意：重基时，switch 所在的分支不同，则最终形成的提交记录亦有所不同，这一点很重要。】
git switch dev
git merge main

注：Merge 和 Rebase 的区别。【参考视频】

2、杂七杂八

（1）合并冲突。
【1】各分支提交的节点就像是各集合中的元素一样，而分支的合并就像是集合的合并，各分支相同的部分（基于某个节点开始分支之前的部分）就像是集合相交的地方。【2】而节点对应的都是关于文件的修改操作内容，如果两个分支的所有节点所对应的文件并没有相同的部分，那么两分支的所有节点都可以不分先后的顺利合并而不影响最终的结果。而如果两分支的节点有相同的操作文件，或者一个分支的节点中有相同的操作文件，那么就会出现冲突或只能按顺序进行。冲突的部分程序不会进行修改解决，但是他会标记出来然后由人手动进行修改。【3】当我们对分支进行合并时，即便存在冲突 git 也会进行合并处理，然后指出冲突文件，当认为修改之后就又会产生一次冲突修改的提交。

（2）什么是 HEAD。
HEAD 相当于数据结构链表中的头指针，通过这个头指针来在各个提交记录的节点上进行移动，进而展现不一样的目录树以及其它的操作。通常 HEAD 默认指向 master 分支的最后一次更新。通过移动 HEAD，就可以比较容器的变更到要使用的 commit，而非一定要取得 commit 的 id 值之后才能进行。

HEAD 的种类：HEAD、ORIG_HEAD、FETCH_HEAD。

（3）提交本地仓库到远端的基础配置。

【1】SSH 密钥认证过程

#（1）生成密钥对，并将私钥放置到家目录
ssh-keygen -t ed25519 -C "你的邮箱"
ssh-add ~/.ssh/id_ed25519

#（2）登录 GitHub，在其 “Settings → SSH and GPG keys → New SSH key” 处将下面公钥的内容添加进去
cat ~/.ssh/id_ed25519.pub

#（3）修改仓库远程地址的格式为 SSH 格式
git remote set-url origin git@github.com:xxx/xxx.git

#（4）配置完毕，测试效果
git push

【2】HTTPS Token 认证过程

#（1）登录 GitHub，在其 “Settings → Developer settings → Personal access tokens” 处新建一个 token。

#（2）设置 git 凭证管理器
git config --global credential.helper store

#（3）执行 push 操作，然后根据提示登录。【注意：用户名：GitHub 账户、密码：填 Token，而非 GitHub 账号的密码。】
git push

#（4）成功登录之后，在用户的家目录下，会出现一个 .git-credentials 的文本文件，文件中记录着登录的账户和 token 的值。

（4）Git 图形化工具推荐：GitKraken、GUI-Client 列表。