Git Guide

内部机制

使用这张图做一个不恰当的对比，借此想给你一个对于 Git 直观的印象，Git 底层就是一个键值对数据库！

Git 基于键值对数据库为为我们提供了非凡的版本控制的功能，以下将探讨它是如何提供这样的功能的！

对象

Git 创建的所有对象都存储在 .git/objects/ 目录下

并且 Git 会自动的就将大量的对象进行打包，以此减少内存占用

Git 中核心对象主要就 3 种，分别是 blob object，tree object，commit object。Git 在创建对象时会根据其内容生成 40 位的校验和，并以此作为键来引用该对象。

Bobl Object: 任何文件都会转变成 Bobl Object，它不记录文件的名称，只保存文件内容。

Tree Object: 由于目录不会转变为 Bobl Object，并且 Bobl Object 也不记录文件名等信息，所以 Git 使用 Tree Object 来充当目录，记录文件名等信息。非常像 Linux 的文件系统。

Commit Object: 每次提交信息都记录在该对象身上，其会指向上一个 Commit Object，并指向当其提交的 Tree Object。Git 的每次提交都相当于对当前项目的一次快照。

上图就是这些对象在 Git 内部的结构。

引用

Git 和你如何记住这 40 位的校验和？

Git 真的是通过写下来记住的 :<，只不过由于Git 组织对象的结构方式，使只需记住少量的 commit object 键值，就可以容易的顺藤摸瓜准确的获取期望的 coomit object

Git 所有的引用分别存储在 .git/refs/ 目录下，以及 .git/HEAD 文件

分支引用: 所有的分支，Git 都对其最新的 commit object 留有一个引用，引用名称就是分支名，存储在 .git/refs/heads/xxBrach 文件中

HEAD 引用: HEAD 引用很特殊（因为它还可以引用其它引用），Git 把 HEAD 引用作为当前仓库版本，以此解决新建提交时获取父 commit object 引用的问题。 存储在 .git/HEAD 文件中

标签引用: 我们打的标签其实就是对指定 commit 的引用， 存储在 .git/refs/tags/xxTags 文件中

远程引用: 其特殊的一点是其引用方式是 远程引用名称/引用分支，比如 origin/master，存储在 .git/refs/remote/origin/xxBranch 文件中

分区

Git 将版本控制系统分成了三个部分: 工作区，暂存区，仓库

1. 我们通过 HEAD 引用来从仓库中指定当前工作目录(Tree Object)所属的 commit object。
2. 暂存区总是会保留上次提交时的内容，在提交时，Git 会根据暂存区的内容和 HEAD 引用来生成 commit object。
3. 仓库内的所有 commit object 都可以通过其引用或 40 位的检验和来被引用。

远程分支

Git 核心理念之一就是分布式！但远程分支在本地是只读的！

工作流

git指令

git配置

# 设置全局的用户名和邮箱地址
git config --global user.name "John Doe" 
git config --global user.email johndoe@example.com

# 查看某一项配置
git config <key>

# 查看所有配置及配置文件所处位置
git config --list --show-origin

# git别名 
git config --global alias.clearlog 'log --oneline --graph --all' 

创建Git仓库

# 创建一个本地仓库
git init

# 克隆现有仓库
git clone <url>

忽略文件# 销某次提交(用

文件 .gitignore 的格式规范如下：
• 所有空行或者以 # 开头的行都会被 Git 忽略。
• 可以使用标准的 glob 模式匹配，它会递归地应用在整个工作区中。
    * (*)匹配零个或多个任意字符
    * [abc] 匹配任何一个列在方括号中的字符
    *（?）只匹配一个任意字符；如果在方括号中使用短划线分隔两个字符， 表示所有在这两个字符范围内的都可以匹配
    * （**）表示匹配任意中间目录
• 匹配模式可以以（/）开头防止递归。
• 匹配模式可以以（/）结尾指定目录。
• 要忽略指定模式以外的文件或目录，可以在模式前加上叹号（!）取反。

# 忽略所有的 .a 文件
*.a
# 但跟踪所有的 lib.a，即便你在前面忽略了 .a 文件
!lib.a
# 只忽略当前目录下的 TODO 文件，而不忽略 subdir/TODO
/TODO
# 忽略任何目录下名为 build 的文件夹
build/
# 忽略 doc/notes.txt，但不忽略 doc/server/arch.txt
doc/*.txt
# 忽略 doc/ 目录及其所有子目录下的 .pdf 文件
doc/**/*.pdf

查看信息

# 查看文件状态
git status [-s] 

# 显示当前分支的版本历史
$ git log
$ git log --oneline --all --graph 

# 显示当前分支的最近几次提交, 等同于commit history，只保存local提交历史
$ git reflog

# 查看某一提交详情 
# 指定一个commit:
# 1. short-hash
# 2. HEAD~[N] 当前HEAD所指commit的第前N个commit
# 3. HEAD^[N] 当HEAD所指commit是经过merge而来时，^[N]指定第[N]个参与合并的commit
$ git show [commit]

增加删除文件

# 添加指定文件到暂存区
$ git add [file1] [file2] ...

# 添加指定目录到暂存区，包括子目录
$ git add [dir]

# 添加当前目录的所有文件到暂存区
$ git add .

# 添加每个变化前，都会要求确认
# 对于同一个文件的多处变化，可以实现分次提交
$ git add -p

# 删除工作区文件，并且将这次删除放入暂存区
$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区
$ git rm --cached [file]

# 改名文件，并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]

提交

# 提交暂存区到仓库区
$ git commit -m [message]

# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]

# 提交工作区自上次commit之后的变化，直接到仓库区
$ git commit -a

# 提交时显示所有diff信息
$ git commit -v

撤销

# 撤销某次提交(用新的替换旧的提交对象，而非修改旧的提交对象)
# 如果撤销期间，文件没有变化，那么快照会保持不变，而你所修改的只是提交信息。
git commit --amend 

# 撤销暂存区内的文件
git restore --staged <file>

# 撤销工作区内对文件的修改，还原成上次提交时的样子
git restore <file>

# 查看储藏内容
$ git stash list 

# 暂时将未提交的变化移除，稍后再移入，因为切换分支时必须保持暂存区内容已提交，工作目录没有变动
$ git stash
$ git stash pop

# 查看暂存区内容
$ git ls-files -s


# reset就是控制版本所在，本质上就是在操控working tree, index, commit tree
# 注意 --hard 参数，他会彻底抹杀掉数据.
# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致
$ git reset --hard

# 对于 reset 指令，你要清除暂存区中的内容是什么！！
# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
$ git reset [commit]

# 重置当前分支的引用为指定commit，同时重置暂存区和工作区，与指定commit一致
$ git reset --hard [commit]

# 重置当前分支的引用为指定commit，但保持暂存区和工作区不变
$ git reset --keep [commit]

打标签

# 查看所有标签
git tag

# 查看tag信息
$ git show [tag]

# 创建轻量标签
git tag <tagname>

# 创建附注标签
git tag -a <tagname> -m <message>

# 新建一个tag在指定commit(后期打标签)
git tag -a <tagname> <hashname> -m <message>

# 删除本地tag
$ git tag -d [tag]

# 共享标签，默认分支上的标签不会被同步到远程分支上
git push <remote> <tagname>

# 删除共享标签
git push <remote> --delete <tagname>

# 一次性推送所有标签
git push <remote> --tags

# 新建一个分支，指向某个tag
$ git checkout -b [branch] [tag]

分支管理

# 列出所有本地分支
$ git branch

# 列出所有远程分支
$ git branch -r

# 列出所有本地分支和远程分支
$ git branch -a

# 新建一个分支，但依然停留在当前分支
$ git branch [branch-name]

# 新建一个分支，并切换到该分支
$ git checkout -b [branch]

# 新建一个分支，指向指定commit
$ git branch [branch] [commit]

# 切换到指定分支，并更新工作区
$ git checkout [branch-name]

# 切换到上一个分支
$ git checkout -

# 合并指定分支到当前分支
$ git merge [branch]

# 将当前分支在指定分支上进行变基(rebase)
$ git rebase <branchname>

# 将指定的分支进行变基
$ git rebase <basebranch> <topicbranch>

# 选择一个commit，合并进当前分支
$ git cherry-pick [commit]

# 删除分支
$ git branch -d [branch-name]

# 新建一个分支，与指定的远程分支建立追踪关系
# 如果在一个跟踪分支上输入 git pull，Git 能自动地识别去哪个服务器上抓取、合并到哪个分支
$ git branch --track [branch] [remote-branch]

# 建立追踪关系，在现有分支与指定的远程分支之间
$ git branch --set-upstream [branch] [remote-branch]

# 删除远程分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]

# 在同一个仓库中创建多个工作树，这意味着你可以在不同的分支或提交上同时进行工作，而无需频繁切换分支。
# 更意味着你可以使用 idea 多开多个分支
$ git worktree add <目录路径> <分支/提交>
$ git worktree remove <工作树路径>

远程同步

# 显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL
$ git remote -v

# 显示某个远程仓库的信息
$ git remote show [remote]

# 添加新的远程仓库
$ git remote add <shortname> <url>

# 下载远程仓库的所有变动
$ git fetch [remote]

# 取回远程仓库的变化，并与本地分支合并
$ git pull [remote] [branch]

# 上传本地指定分支到远程仓库
$ git push [remote] [branch]

# 强行推送当前分支到远程仓库，即使有冲突
$ git push [remote] --force

# 推送所有分支到远程仓库
$ git push [remote] --all

引用

# 引用日志，Git 会记录 HEAD 引用的变化日志
$ git reflog
734713b HEAD@{0}: commit: fixed refs handling, added gc auto, updated
d921970 HEAD@{1}: merge phedders/rdocs: Merge made by 
1c002dd HEAD@{2}: commit: added some blame and merge stuff
1c36188 HEAD@{3}: rebase -i (squash): updating HEAD
95df984 HEAD@{4}: commit: # This is a combination of two commits.
1c36188 HEAD@{5}: rebase -i (squash): updating HEAD
7e05da5 HEAD@{6}: rebase -i (pick): updating HEAD

# @{n} 来引用 reflog 中输出的提交记录
$ git show HEAD@{5}


# ^ 祖先引用，指向引用的上一个引用
# ^{num} 适用于合并的提交，因为合并提交会有多个父提交。 
# 合并提交的第一父提交是你合并时所在分支（通常为 master），而第二父提交是你所合并的分支（例如 topic）：
$ git show HEAD^
$ git show HEAD^2

# ~ 祖先引用，指向引用的上一个引用
# ~{num} 指向第一父提交的第一父提交的第一......
$ git show HEAD~2

其它

# 生成一个可供发布的压缩包
$ git archive