Git

学习材料

畅游提交树学习网站

绝对值_x 个人博客

安装与配置

Git 的安装

• 方法一：

官网进入下载即可（笔者采用该方法安装的 git）

安装好之后会在鼠标右键菜单中发现“Git Bash Here”和“Git GUI Here”两个新的选项，这就是 Git 最常用的操作模式，在一个文件夹中右键，“Git Bash Here”对该文件夹内容进行 Git 相关操作。

• 方法二：

采用 windows 包管理器，scoop install git一步到位。

初始化配置

第一次使用 git 需要对用户名和邮箱进行配置，配置代码如下：

git config --global user.name "YourName"
git config --global user.email "your-email@example.com"

其中，以上两行代码一句一句分开输入，在“Git Bash Here”或者终端管理员中输入均可，双引号内的内容需要自己根据实际情况填写，这两个命令只需要执行一次，如果之前执行过的话可以跳过。

注：如果使用 VSCode 作为代码编辑器，推荐搭配Git Graph插件一起使用

SSH 配置

若要使用 SSH 链接连接到远程仓库，需要对 SSH 进行配置

1. 生成密钥对

ssh-keygen -C "YourEmail@example.com"

在 git bash 输入以上命令，会要求输入密钥对保存路径，以及密钥对密码，密码为空即可。可以一路回车，但是要注意密钥对的保存路径，生成完毕后要到该路径下读取密钥对文件，选择“id_rsa.pub”文件并打开，里面“看起来像乱码的东西”就是 SSH 公钥。

2. 进入 Github 配置 SSH 公钥

在 Github 右上角头像处选择 Settings，进入设置页面后选择 SSH and GPG keys，点击 New SSH key 按钮，在 Title 处填写一个名字，在 Key 处填写密钥对文件中的公钥内容，最后点击 Add SSH key 按钮即可。

3. 测试 SSH 连接

ssh -T git@github.com   # 输入该命令验证是否成功

仓库

新建仓库

• 方法一：

git init

在需要构建仓库的文件夹下“Git Bash”（后同），通过该命令可以新建一个自己的本地仓库

• 方法二：

git clone <ssh path>

通过该命令可以克隆 github 上的开源代码，克隆别人的仓库到本地。

Git 跟踪文件的三个区域

• 工作区
• 暂存区
• 本地仓库 工作区 ---git add---> 暂存区 ---git commit -m '注释'---> 本地仓库 ---git push origin main--> 远程仓库

工作区，即为本地文档未上传时所处区域，在本地文件夹内新建文件，该文件就直接处于工作区。之后通过 add命令，可以将文件从工作区转移至暂存区，此时再commit，便可以将文件上传至本地仓库。

暂存区存在的原因在于，在提交文件至本地仓库时，可以每一次先将文件上传至暂存区，之后再一次性提交至本地仓库，这样可以避免每次提交都上传一次文件，提高效率。

畅游提交树

基础命令

• git commit git commit 将暂存区文件提交至本地仓库，并且每一次的提交可以看做是一次文件的快照，正是一个个提交组成了一个文档开发过程中的提交树，git 提供了多种方式让开发者可以在提交树中畅游，commit 也是 git 最基本的命令。

commit 命令会在提交树上新建一个新节点，例如原节点为C0，提交后产生新节点C1，则二者的关系为 C0<-C1，表示C1是从C0提交过来的，C0为C1的父（parent）节点。注意箭头方向，箭头方向为提交树创建的反方向，并不代表文件的更新方向。

• git branch git 中的分支，让开发效率大幅提升，开发团队可以在分支上修正 bug，或开发新特征，但是不影响主线项目的正常运作，“早建分支！多用分支！”，使用分支其实是在说：“我想基于这个提交以及它所有的 parent 提交进行新的工作。”

git branch <branch name> 创建新分支并命名。注意：main是一个特殊的分支，git 把main分支看做是提交树的主干，故新分支的名称不能是main。仍需要注意的是，假设现提交树为C0<-C1，如果我们处于main分支上，则main分支指向最新的提交，表示为：C0<-C1<-main*（*号表示所处分支），若现在通过git branch newImage创建了新分支，此时新分支会指向最新提交，但是我们仍然处于main分支上。

即提交树变为：C0<-C1<-(main* newImage)

若要切换到新分支，可以git checkout <branch name>，此时提交树变为：C0<-C1<-(main newImage*)，值得注意的是，git checkout本质是在改变HEAD的指向。若git checkout <commit name>指向了某个提交而不是分支，此时会进入detached HEAD状态。

简单地，git branch -b <branch name>可以创建分支并且把当前分支切换为新分支。有关分支的配置可以参考以下命令：

git branch -a                    # 查看分支
git branch <new_branch_name>     # 新建分支
git branch <new_branch_name> <commit> # 在指定节点处新建分支
git switch <branch_name>         # 切换到分支
git checkout -b <branch_name>    # 新建并切换到分支，trick
git branch -m <old_name> <new_name> # 重命名分支
git branch --delete <branch_name>   # 删除分支
git push origin -d <branch_name> # 删除远程分支

• git merge 在分支开发完毕之后，需要将分支与 main 分支合并，此时需要用到git merge命令，这个命令产生的 commit 快照会有两个父节点，一个来自于 main 分支，一个来自于新建的分支。

git merge <branch name>注意这里的<branch name>是需要合并的分支，如：在 main 分支上执行git merge newImage，则代表将 newImage 分支合并至 main 上，此时会新建一个快照，这个快照有两个父节点，并且该快照为提交树中最新的快照，包含了代码库的所有修改。

• git rebaserebase是取出一系列的提交记录，“复制”它们，并在另外一个地方逐个地放下去，其优势在于可以创造更线性的提交历史。

如在newImage分支上执行git rebase main，则代表将 newImage 分支上的提交记录复制到 main 分支上，并且在 main 分支上逐个地放下去。值得注意的是，这个过程中，原newImage分支上的提交快照不会消失，而是没有分支节点指向它们。在rebase之后，newImage分支会在main后创建有一定顺序的快照副本，newImage指向最新的快照副本，接下来需要更新main：在git checkout main切换到main分支后，git rebase newImage即可将main也移动至newImage指向的快照副本。

git rebase -i提供了 UI 界面（Git 会进入 vim 编辑器），可以对提交记录进行重新排序/删除等操作。

git rebase <branch1> <branch2>，通过后面的两个分支，可以将<branch2>分支移动至<branch1>分支下。

进阶命令

• HEADHEAD是一个对当前所在分支的符号引用——也就是指向你正在其基础上进行工作的提交记录。HEAD也总是指向当前分支上最近一次提交记录，HEAD通常情况下是指向分支名的。

一般来说，一个提交快照的结构应该是这样的：C1<-branch<-HEAD，即：分支直接指向提交，而 HEAD 指向分支。但如果 HEAD 指向了提交本身，如：git checkout C1，此时我们称此类现象为detached HEAD

• 利用HEAD进行相对引用 使用^向上移动 1 个提交记录，使用~<n>向上移动 n 个提交记录。如main^，即为main分支最新一次提交的上一次提交。

• 分支的强制提交 git branch -f main HEAD~3，可以将main分支强制移动至HEAD前三级的父节点上，同时不改变HEAD本身的指向。

• 撤销变更 git reset <point_to> 把分支记录回退几个提交记录来实现撤销改动。但是这对于远程分支（remote branch）无效

git revert <point_to> 撤销更改并分享给别人，需要采用该命令。例：设已有提交树C0<-C1<-C2<-main*，执行git revert HEAD后，得到提交树C0<-C1<-C2<-C3<-main*，其中C3为撤销C2的提交记录，即C3与C1的提交记录相同，现将C3上传至远程分支即可同步“撤销”的过程。

• 移动提交记录 git cherry-pick <commit>使用该命令后，可以将<commit>复制至当前HEAD所处分支之后，并且 HEAD 与所处分支移至最新节点，其中<commit>可以选择多个节点，用空格隔开。

远程仓库

处于协同开发与开源的需要，将代码上传至 github 等托管平台能够使代码社交化，也会得到一份牢靠的代码备份。我们把部署在 github 上的仓库称为远程仓库。

• git clone <ssh path>可以从 github 上克隆一个仓库，并将该远程仓库与克隆后的本地仓库建立连接。
• 链接远程仓库
  SSH

git remote add origin git@github.com:<yourgithubID>/<Repo>.git

@ tab HTTPS

git remote add origin https://github.com/yourgithubID/gitRepo.git

:::

优先使用 SSH 链接，但需要配置

其中<yourgithubID>为你的 github 用户名，<Repo>为你的仓库名

origin为远程仓库别名，一般习惯设置为origin

• 远程分支 在 clone 新的仓库之后，本地仓库会多出一个<remote repo name>/main分支，这种类型的分支即为远程分支，当切换到远程分支时，HEAD 会自动进入HEAD detached状态，git 这么做是因为不能直接在这些分支上进行操作，而必须在别的地方完成工作后再远程分享成果。

• git fetch git 远程仓库相当的操作实际上归纳为两点：向远程仓库传输数据以及从远程仓库获取数据。git fetch能够从远程仓库获取数据

例现有本地仓库和远程仓库为：

本地仓库：C0<-C1<-(main* origin/main)

远程仓库： C0<-C1<-C2<-C3<-(main)

在git fetch后，

本地仓库：C0<-C1(<-main*)<-C2<-C3(<-origin/main)

可以看出本地仓库只更新了origin/main分支，而并没有移动main和HEAD的位置。

• git pullgit fetch只实现了远程仓库的下载，但是并没有更新本地仓库，需要再次通过merge命令将远程分支和本地分支合并。但是git pull提供了更为方便的选项，可以直接将远程仓库下载下来，并且将远程分支和本地分支合并。

• git pushgit push能够将本地仓库的更改上传至远程仓库，将远程仓库的分支状态与本地仓库的本地分支同步，同时将本地仓库的远程分支与本地分支合并。

一般来说，要为push添加指定参数，语法是git push <remote> <place>，一般而言，该命令设置为git push origin main，把这个命令翻译过来就是，切到本地仓库中的“main”分支，获取所有的提交，再到远程仓库“origin”中找到“main”分支，将远程仓库中没有的提交记录都添加上去。此处，push 的来源于目的地是一致的，仅需一个main参数即可，但是若不一致，则需要设置成<source>:<destination>，即语法为：git push <remote> <source>:<destination>。

类似的，fetch和pull也支持指定参数，只不过由于数据传输的方向和push相反，其<source>和<destination>的设置也应该和push中相反。

• 协同开发存在的问题 但是实际情况并不是这么简单的，实际情况可能是，本地仓库与远程仓库内容不统一，因为协同开发时两边均在做修改，此时远程仓库和本地仓库的分支存在 conflict，git push无法执行。有三种方法可以解决这个问题：

方法一：

git fetch
git merge o/main
git push

方法二：

git fetch
git rebase o/main
git push

但是这样命令数太多了，之前说过git pull是fetch和merge的组合，因此法一可以变为：

方法一：

git pull
git push

git pull写作git pull --rebase时，可以实现法二，即：

方法二：

git pull --rebase
git push

相较于 merge，项目管理更喜欢用 --rebase 版本，因为rebase带来了更为线性的提交树，提交树结构清晰。

方法三：

git stash   # 暂存代码
git pull origin main    # 拉取上游
git stash pop   # 释放代码，进行合并
git stash drop  # 解决冲突后，请释放未被 pop 出的 stash

git stash可以帮助暂时保存当前代码，再 pull 远程仓库的代码进行合并。

• Pull request 对于大团队开发协作而言，main分支往往被锁定了，此时若强行 push，会报错如下：

! [远程服务器拒绝] main -> main (TF402455: 不允许推送(push)这个分支; 你必须使用pull request来更新这个分支.)

解决方法

新建一个分支 feature

push 到远程服务器，然后 reset 你的 main 分支和远程服务器保持一致，否则下次你 pull 的时候会报错