Git中常用的操作

几个概念

工作区 (Workspace): 通俗地理解就是本地的环境，一般来说代码就是在工作区打开和编辑的。

暂存区 (stage, index): 这个信息存放在 .git 目录下的 index 文件里面

远端

0. 配置 ssh

0.1 Generate

$ ssh-keygen -t rsa -C "506834968@qq.com"
#一直 Enter 即可

$ eval "$(ssh-agent -s)"
$ ssh-add ~/.ssh/id_rsa

0.2 在 Github 中添加 SSH

把 ~/.ssh/id_rsa.pub 中的内容复制到 Github 新生成的密钥

$ clip < ~/.ssh/id_rsa.pub
$ ssh -T git@github.com
Hi huweim! You've successfully authenticated, but GitHub does not provide shell access.

现在即可正常 push

0.3 用户名和邮件设置

git config --global user.name huweim
git config --global user.email "506834968@qq.com"

1. Remote Repo

1.1 Add Remote Repo

$ git remote add origin git@github.com:huweim/repo_name.git

1.2 Delete Remote Repo

  • Add a wrong remote repo, we could delete it.
$ git remote -v
origin  git@github.com:huweim/huweim.github.io.git (fetch)
origin  git@github.com:huweim/huweim.github.io.git (push)
  • Delete it
$ git remote rm origin

1.3 Pull Origin Master to Local

❌似乎 push 之前如果有东西需要先 pull

  • 是因为远端已经创建了 README.md，local 也有README.md。有冲突，所以需要先 pull 过来同步。

git pull 命令用于从远程获取代码并合并本地的版本。

git pull 其实就是 git fetch 和 git merge FETCH_HEAD 的简写。 命令格式如下：

git pull <远程主机名> <远程分支名>:<本地分支名>

将远程主机 origin 的 master 分支拉取过来，与本地的 brantest 分支合并。

git pull origin master:brantest

如果远程分支是与当前分支合并，则冒号后面的部分可以省略。

git pull origin master

本地有修改，但是想用 remote 文件直接覆盖本地文件

# 暂时将工作区和暂存区代码保存
git stash
git pull

# 如果想查看 stash list 以及清除之前的修改
git stash list
git stash clear

上面命令表示，取回 origin/master 分支，再与本地的 brantest 分支合并。

1.4 Clone from Remote Repo

$ git clone git@github.com:huweim/repo_name.git
$ git clone https://github.com/huweim/repo_name.git
  • 很多时候http速度很慢，会clone失败报错，所以建议使用ssh。

2. 代码提交

包括 git add, git commit, git push, git merge

2.1 git add

3. Delete

3.1 删除工作区文件

  • 与win中右键删除没有区别

  • If you want to remove the file from the Git repository and the filesystem, use:

git rm file1.txt   #删除file1.txt
git commit -m "remove file1.txt"

3.2 仅删除暂存区中的文件

But if you want to remove the file only from the Git repository and not remove it from the filesystem, use:

git ls-files #查看暂存区文件
git rm --cached file1.txt
git commit -m "remove file1.txt"

And to push changes to remote repo

git push origin branch_name

3.3 删除文件夹 (踩坑)

  • 主要是由于之前commit过某些文件和文件夹，导致无法忽略这些文件
  • 采用命令git rm –cached “文件路径”
  • 删除文件夹的时候，出现 not removing ‘game/logs’ recursively without -r，说明我们需要添加参数 -r 来递归删除文件夹里面的文件
  • git rm -r –cached “文件路径”
  • 然后commit

3.4 删除分支

git branch -a		#查看
git push origin --delete <branchName>  #删除

4. 回滚

  • HEAD指向的版本就是当前版本，因此，Git允许我们在版本的历史之间穿梭，使用命令git reset --hard commit_id。
  • 穿梭前，用git log可以查看提交历史，以便确定要回退到哪个版本。
  • 要重返未来，用git reflog查看命令历史，以便确定要回到未来的哪个版本。

4.1 查看历史版本

4.1.1 查看过去

  • git log命令显示从最近到最远的提交日志

  • commit_id（版本号） 964ab89b23c2…….

  • $ git reset --hard commit_id
$ git reset --hard 964ab89

  • 知道commit_id可以回到过去的版本

$ git log
commit 964ab89b23c2aa367c89ee2e9578e1398819d523 (HEAD -> master, origin/master)
Author: huweim <506834968@qq.com>
Date:   Mon Mar 8 15:43:24 2021 +0800

    add first post

commit bd6582181e070822896bbb8cfb2b3a3e80cf3163
Author: huweim <506834968@qq.com>
Date:   Mon Mar 8 15:30:25 2021 +0800

    Full themes of archie

4.1.2 寻找未来

  • git reflog查看命令历史
  • 根据commit_id寻找当前版本的“未来”
$ git reflog
964ab89 (HEAD -> master, origin/master) HEAD@{0}: commit: add first post
bd65821 HEAD@{1}: commit: Full themes of archie
23ca6d2 HEAD@{2}: commit: modify the hugo themes
a6ad376 HEAD@{3}: reset: moving to HEAD^
4eaa987 HEAD@{4}: reset: moving to HEAD^
d7770ba HEAD@{5}: commit: Publish fitst 1
4eaa987 HEAD@{6}: commit: Publish fitst
a6ad376 HEAD@{7}: pull: Fast-forward
6db58f9 HEAD@{8}: commit (initial): Initial Commit

4.2 撤销修改操作

Case 1 -> 修改了file，还未add

Case以文件 README.md 为例

git checkout -- file

e.g

git checkout -- README.md
  • 丢弃工作区的修改，回到上一次commit时的状态。

2022-11-23 21:18:33，这个可能会比较常用，实际上回到上一次 commit 的状态也比较安全。但是当前在工作区的改动会丢失。

Case 2 -> 修改了file，且已经add

git reset HEAD <file>    #撤销对暂存区的修改  回到case 1的状态
git checkout -- file     #情况来到case1, 撤销工作区修改

e.g

git reset HEAD README.md
git checkout -- README.md

case 3 -> 修改了file，且已经add，并commit

git reset --hard HEAD^    #回到上一个版本，回到case 2的状态
git reset HEAD <file>     #撤销对暂存区的修改  回到case 1的状态
git checkout -- file      #情况来到case1, 撤销工作区修改

e.g

git reset --hard HEAD^
git reset HEAD README.md
git checkout -- README.md

4.3. 版本回退

git reset --hard HEAD^    #回到上一个版本
git reset --hard HEAD^^   #回到上上一个版本
git reset --hard 1084a    #回到commit_id以1084a开头的版本
git reset --hard HEAD~100 #回到上100个版本

4.4 回滚后在提交（坑）

I. 基本操作

git add -A   
git commit -m '说明'
git push -u origin master

II. 报错

在执行push -u origin master 命令后报错

error: failed to push some refs to 'github.com:huweim/huweim.github.io.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

报错原因-> 当前提交版本低于git主版本

III. 解决方法

push -u origin master -f
  • -f 覆盖当前主分支 如果您的仓库只有自己在玩,这个命令可以随意使用
  • 如果你是协同开发共用仓库,请务必不要带 -f 参数提交代码,后果不亚于 删库跑路

5. 分支

5.1 概念

conflict，两个文件合并时可能会出现冲突，如何定义冲突？

A conflict arises when two separate branches have made edits to the same line in a file, or when a file has been deleted in one branch but edited in the other.

看起来是按行进行索引。

出现冲突的场景

  • 不同分支，modify same file, same line
  • 不同分支，modify same file, adjacent line

5.2 分支合并

2022-11-23 21:27:36。分支可能是 git 的一个特色了，但自己从来没有使用过这个功能。

# 查看本地分支
$ git branch
* main

# 查看本地分支和 remote 分支
$ git branch -a
* main
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

分支合并 (git merge)。独立开发了某个功能，最终还是要将他们合并到主分支的。目前没有用过这个东西，但是可以了解一下他的逻辑。

$ git branch  
* master
  branch_test
$ git merge branch_tst
# 应该是默认合并到当前 branch

$ git branch -d branch_test

5.3 解决 remote 和本地冲突 ⭐

这个在自己最近（2022-11-23 22:04:27）的开发场景中经常出现，情况就是和别人合作进行开发，当别人已经 push 了新的改动，而自己在本地也做了一些修改，但是还没有 push。这时会先把别人的改动 pull 下来，但是可能会产生冲突。

粗暴的方法 1 是保存下自己的修改，直接重新 clone 一份代码，然后再加入自己的修改。但是当工程量增大时，手动操作也容易不错，并且不太方便。

我自己的方法 2 是保存下自己的修改，通过 git stash 暂存本地代码，注意 git stash 会回退到上一次的 commit。虽然自己的本地代码会保存下来，用 git stash list 还可以查看，但是自己从来没有用这个恢复过。总的来说也有可能出错，不太方便。

目前学到的方法 3 是可能会比较方便。

  • 首先，通过 git add; git commit 提交本地的修改
  • git pull 直接拉取并且 merge，没有冲突时会自动 merge；出现冲突时，上面描述了方法 1，2，下面是方法 3
# #查看一下本地分支和 remote 分支的名字
# $ git branch -a 
# * main
#   remotes/origin/HEAD -> origin/main
#   remotes/origin/main
# # 对比冲突
# $ git diff main remotes/origin/HEAD

# 使用 diff 还是不行，还是使用插件 git lens

$ git pull
Auto-merging tex/evaluation.tex
CONFLICT (content): Merge conflict in tex/evaluation.tex
Automatic merge failed; fix conflicts and then commit the result.
# 告知有冲突，此时通过可以对比冲突出现的位置，手动解决之后再次 git add, commit 然后 pull 即可。

2022-11-23 22:29:06，不能直接 git diff，这样会对比所有的文件，而我们只希望对比冲突的文件。 实际上，git lens 这个插件就是在实现 diff 的功能，只是其标注出了冲突的位置

5.3.1 实例

比如用 ISCA paper 来测试一下

# 直接 pull 出现冲突，因为在 overleaf 上已经改了很多次了
$ git pull
error: Your local changes to the following files would be overwritten by merge:
        tex/evaluation.tex
Please commit your changes or stash them before you merge.
Aborting
Updating e83209c..44817d2
先 commit 自己的提交
$

5.4.1 冲突测试

6. Git常用命令速查表

7. Bug

7.1 failed to push some refs to git

出现错误的主要原因是github中的README.md文件不在本地代码目录中

git pull --rebase origin master

重新 push 即可解决，理解为合并分支

7.2 master, main 分支名不同

error: src refspec main does not match any. error: failed to push some refs to ‘git@github.com:huweim/ant_extension.git’

解决：本地分支名字改为 main

git branch -m master main

8. submodule

Hugo 中修改 theme 属于更新 submodule，不能直接 git add，要使用命令 git submodule update

git submodule update --remote 
# 这个是从子模块的 remote 端克隆最新版本到本地，会覆盖本地的文件

9. Branch

git branch -a     # 查看所有分支
git branch        # 查看当前使用的分支
git branch XXX    # 创建分支 XXX
git checkout XXX  # 去往另一个分支

VSCode BUG

Missing or invalid credentials. Error: connect ECONNREFUSED /run/user/2039/vscode-git-5fd9577edd.sock

解决：https://juejin.cn/post/7062237873570840589，取消 git.terminalAuthentication 中的勾，然后 reload。

2022-08-05 19:59:13，这个方法不太行，搞了之后需要重新输密码。再遇到这个错误可以先重启几次。

Reference

https://www.jianshu.com/p/bc067471781f

https://www.runoob.com/git/git-basic-operations.html

https://www.liaoxuefeng.com/wiki/896043488029600/897013573512192