Intro
最近高强度使用github，遂小计于此作为备忘。
Basic
github是一个代码管理软件，能够track文件变动并且管理版本，是当代coding必不可少的工具。当你安装好github在本地以后，你可以通过以下命令初始化当前文件夹（假设是/WorkingSpace）的github管理
cd WorkingSpace
git init
此时/WorkingSpace下会创建一个隐藏文件夹.git，它负责储存所有有关github的内容。
在初始化之后，当前的仓库并没有track任何文件。运行以下命令将file加入track列表中
git add file
正如linux的文件操作，你可以使用.来代表当前文件夹下的所有文件，通过以下操作你可以一键加入当前文件夹下的所有文件
git add .
但是在复杂仓库的管理时切忌直接使用以上命令，很容易track很多无意义的文件，导致不必要的冗余与开销。你可以创建.gitignore文件在/WorkingSpace下，直接将忽略的文件写在.gitignore中，每个文件一行，如
file
每一次git add操作会将文件放入缓存区，使用git commit将当前缓存区的内容记录为一个新的版本
git commit -m "This is your commit message."
每一次commit都有对应的ID，你可以通过reset命令回到某个历史的版本中
git reset XXXXXXXXXXXXXXXXX
此类reset为soft reset，只会改变当前的版本号，并不会改变本地的文件。
推荐使用VS Code的github功能，你可以直观地使用进行管理、查看版本号。VS Code在此命令后会显示旧版本与本地文件的区别。
你还可以使用hard reset改变本地的代码（本地代码将强制更改为某个版本的代码，很难找回！！！）。
git reset --hard XXXXXXXXXXXXXXXXX
你还可以使用HEAD表示当前最新的版本号，这个命令可以帮助你快速清空缓存区。
git reset --hard HEAD
事已至此你成功维护了本地的github仓库。
照着github的Create Repository，你可以创建一个线上的github仓库，便于备份与合作。你也可以直接clone一个远程仓库到本地
git clone git@github.com:UserName/RepoName.git
git clone https://github.com/UserName/RepoName.git
你可以用pull将线上拉取到本地，用push将本地更新到线上
git pull
git push
由于git的要求，你必须从当前git的最新版本进行更新，再push，否则你需要先与最新的版本进行手动的commit。由于这个特性更多时候版本更新是线性的，在最后再merge起来。
Merge：你可以使用git pull拉取远程仓库，此时相同的文件将会存在本地和远程两个版本，你需要逐行确认保留远程版本还是本地版本（在VS Code上）。
你也可以使用hard命令强制覆盖Remote仓库（非常危险，很难找回！！！）
git push --hard
Branch
获取当前Local与Remote的Branch list.
git branch -a
从remote上新建分支（LocalBranch的名字尽量与RemoteBranch名字相同，否则有可能会出现问题）
git checkout -b LocalBranch origin/RemoteBranch
切换至LocalBranch（需先将缓存区清空，如git reset --hard HEAD）
git checkout LocalBranch
同一份代码也可以有不同的remote repo，你可以将本地仓库与某个远程仓库绑定，你可以用这个方法clone别人的代码并维护一个属于自己的仓库
git remote set-url origin git@github.com:UserName/RepoName.git
当remote的branch信息更新时，本地需要额外的fetch进行更新（prune会删除remote中不存在的branch）
git fetch --prune
你可以使用-d删除本地分支（-D为不顾及是否merge强制删除）
git branch -d LocalBranch
Bug
fatal: The current branch main has multiple upstream branches, refusing to push.
-
原因是当前branch在push的时候不知道自己的上游是什么，没有关联起来。使用
--set-upstream将本地LocalBranch与远程的RemoteBranch关联起来。git push --set-upstream LocalBranch RemoteBranch
当使用git branch -a时，会输出
* main
remotes/origin/main
这意味着--set-upstream的姿势应该是
git push --set-upstream origin main