Git 使用手册

本手册整理于Learning Git Branching，用过关的形式来逐步练习，并用动画来呈现git中的关系，非常直观有趣。常用本地和远程指令讲解练习都有，几个小时就可以做完。

规范化git更新日志

在下面这个例子中，格式的各个部分含义如下：

Features: 这部分列出了新版本中添加的新功能。每一项都包含一个提交的哈希值、一个简短的描述和一个可能的问题编号。
Bug fixes: 这部分列出了新版本中修复的错误。格式与 Features 部分相同。
提交的哈希值（e6a1db2）: 这是 Git 提交的唯一标识符，可以用来在 Git 历史中找到这个提交。
方括号中的内容（[bgnotify]）: 这通常表示这个提交影响的是哪个部分或者模块。
描述（Add support to wayland）: 这是对这个提交做的更改的简短描述。
问题编号（#12045）: 如果这个提交是为了解决一个在问题跟踪系统中报告的问题，这个编号可以用来找到那个问题的详细信息。

Features:

 - e6a1db2 [bgnotify] Add support to wayland (#12045)
 - e021334 [vi-mode]  Add option to disable clipboard (#12037)

Bug fixes:

 - c8e600f [direnv]   Initialize properly direnv
 - 6165c25 [grc]      Source grc.zsh on gentoo (#12050)
 - 22f9a8d [juju]     Add `public-address` fallback to `jaddr` (#12046)

本地git操作

1. 建立分支，commit操作

git commit：在当前分支下留下commit。
git branch <b-name>：建立新分支。
git checkout <b-name>：从当前分支切换新分支。

2和3也可以联合起来用一个git checkout -b <b-name>实现，表示建立并直接切换至新分支。

2. 合并分支

git merge <b-name>：合并分支到main（或者master）上（当前在main上）。

如果需要吧main合并到分支b1上，则：
1
2
git checkout b1
git merge main
先切换分支，然后把main合并过去。
git rebase <b-name>: rebase的第一个作用是合并多个commit为一个commit，第二个作用是将一段commits粘贴到另一个分支上。假设现在在b1分支上，如果执行git rebase main则会把main当前HEAD的commits都复制到b1上，并且还保有main。

3. 分支内操作

HEAD为路径下指向的最近提交，在当前路径上可以用git checkout <node name>来移动HEAD的位置。
^数字：表示在当前分支或HEAD处向上移动数字n个提交记录。引用^这时放在引用后面表示寻找引用的父节点，比如main^表示main的父节点，main^^表示main^的父节点。
~:表示向上移动，~n表示向上移动n个点，n最小为1。
git branch -f main HEAD~3：表示切换到main路径并指向HEAD的向上3级父提交。
撤销变更git reset HEAD~1和git revert HEAD。reset直接倒退回上一次提交，这样会导致commit不可见，所以一般用在本地。revert一般用在远程，也是返回上一次提交，但是他是延伸出一个节点并表示上一次提交，是可见的撤销。

4. 自由修改提交树

git cherry-pick <n1,n2...>：表示把节点n1，n2等等直接接到当前路径的HEAD下。
git rebase -i HEAD~3：当想修改当前路径下多个commits时，可以在rebase -i来打开交互界面，通过omit来隐藏不需要的节点，通过拖动改变节点顺序，确认之后就可以按照交互操作生成一个新的分支。

5. 本地提交杂项

快速提交，可以用rebase -i或者cherry-pick来选择需要提交的commit，补充一条git rebase branch1 main就相当于git checkout main加上git rebase branch1，也就是从branch1跳到main后再将branch1接到main候面。
在一个分支上b1又建立了新分支b2，并且已经有提交，现在想返回老分支b1做修改。
- git rebase -i HEAD~2：调整顺序并建立新分支。
- git commit --amend：对HEAD节点加入修改。
- git rebase -i HEAD~2：在对当前分支把顺序调回来并生成新分支。
- git rebase b1 main：把main移动到b1最前端。
上面的操作会导致排序太多，所以还可以用cherry-pick来操作：
- git checkout main：返回main。
- git cherry-pick C2：只把原本的C2点拿出来加到main下面。
- git commit --amend：在C2点上做修改。
- git cherry-pick C3：再把原本C2的子节点C3也拿过来接在C2上。
可以用git tag <tag-name> <n-name>来给node添加tag，也可以用checkout找到node再直接tag。
git describe <ref>的返回值是<tag>_<numCommits>_g<hash>，其作用是查询离当前最近tag差多少个提交记录，hash表示给定的ref的前几位。

6. 本地进阶

多项rebase, 使用git rebase b1 b2来把b2接到b1上并且路径设为b2.
main^2表示main的另一个父递交，此外^和~可以链式操作。

远程仓库git操作

1. 基本操作

git clone : 从远程仓库复制到本地，或者把本地很远程连接。一般复制完本地会有o/main的分支，这个是远程分支。远程分支的命名规范是<remote name>/<branch name>，所以这里的o是origin。
远程分支在检出时，会进入分离HEAD状态。为的是不让main的操作直接留在o/main上。在本地上要注意做提交时所处的分支。
git fetch：从远程仓库获取数据（通信，或者就是下载），获得本地仓库缺失的提交记录，并更新远程分支指针（如：o/main）。但是并不会改变本地仓库的状态，也不会更新main分支，也不会修改磁盘上的文件。

通常通过互联网（http://或者git://与远程仓库通信）。
git pull：先抓取更新在进行合并。其作用和git fetch加上git merge是一样的效果。
git push：将我的变更上传到指定远程仓库，并在远程仓库上合并我的新提交记录，也就是说在push之后小组其他成员就可以从远程仓库上下载我的推送成果了。

push不带参数时的行为与git default配置有关。默认值取决于正在使用的git版本。
提交偏离得问题会导致在push得时候跟不上远程仓库的版本，git会强制开发者先合并最新的代码，然后才能push。
- 可以先fetch远程仓库，然后rebase到本地的o/main上，把个人工作移动到最新提交记录下，然后再用push（简写指令为git pull --rebase）。
- fetch-merge-push的顺序也可以，这种与rebase的不同在于，将本地的提交与o/main无抹除合并（以分支的形式），然后提交到远程仓库时也是分支得形式(简写git pull)。
但是一般都不允许直接在master上进行push，需要配置pull requests来提交更新。

具体操作：
- git reset --hard o/main把o/main与本地的main重置到一起。
- 然后git checkout -b feature C2建立新的分支节点。
- 最后git push origin feature到远程仓库。

2. 高级操作

推送主分支：在个人本地仓库分之多的情况下，需要把所有分支做集成，然后统一推送。
- git fetch：抓取更新
- git rebase o/main side1：合并并定位到side1
- git rebase side1 main1：合并并定位到main
- git push：将集成完毕的记录推送到远程仓库
在合并远程仓库中，既可以选择rebase也可以选择merge，rebase的优点是提交树干净，所有提交都在一条线上。缺点是修改了提交树的历史。merge能够保留提交历史。
- git checkout main：移到本地main上。
- git pull：抓取远程仓库并与之合并。
- git merge side1：合并side1到main上（此时head在main并且main和o/main一起联动）。
- git push：保留所有提交历史将相同的提交记录推送到远程仓库。
远程跟踪，在clone得时候git就会在本地创造一个远程分支（如o/main），以及跟踪远程仓库中活动分支的本地分支（如main）。

可以通过自型设定任意分支来跟踪远程分支，这样在push得时候merge目标就是你设定的分支。
- 可通过如下第一种方法设定属性
git checkout -b foo o/main

这样foo在pull或者push得时候就可以直接跟踪远程仓库的main分支。
- 或者用第二种方法：
git branch -u o/main foo

这样foo就会跟踪o/main，如果本身就在foo上，可以直接省略foo。
git push <remote> <place>：对push指定参数，切换本地分支获取所有提交，并在远程仓库origin中找到这个分支并添加上去。如果不指定参数，则会以HEAD的位置进行push。同样可用于pull指令。
<place>参数：上面的参数可以指定来源和目的地<source>:<destination>。在push指令的情况下，source为本地，destionation为远程仓库的指定位置。当使用push如果远程不存在，可以自动生成新分支。
接第五条，在使用fetch指令时，source和destination刚好和上面相反，前者是远程，后者是本地。同样在fetch时本地不存在分支，则会自动生成新分支。如果git fetch没有指定参数，则会下载提交记录到所有分支。
<source>：在push和fetch时也可以不指定任何source，仅保留冒号和destionation。

git push origin :foo传一个空值给source，则直接删除了远程的foo。

git fetch origin :bar则会在本地创建一个新分支。
git pull就等于git fetch加上git merge，而pull唯一关注的时是提交最终合并到哪里（也就是fetch所提供的destination参数）