【Git】之 入门教程 + 使用示例_git操作示例

参考

https://github.com/MarkLodato/visual-git-guide
https://www.runoob.com/manual/git-guide/
https://git-scm.com/doc

Ubuntu上openVPN配置参考： https://www.bbsmax.com/A/LPdoRP9G53/

Git 使用指南：https://www.gjtool.cn/pdfh5/pdf.html?file=https://www.gjtool.cn/pdfh5/git.pdf

文档：A Visual Git Reference.pdf（https://github.com/MarkLodato/visual-git-guide）
链接: https://pan.baidu.com/s/11okGic_Dvl0l5DUV4-mg2g
提取码: zada

Git 作用

最开始接触git是因为github网站上有很多开源的强大项目。（所以很长时间我只是从github上clone代码：https://blog.csdn.net/u010637291/article/details/106241389）

但其实git是一个分布式版本控制系统，类似于常用的版本控制工具 CVS, Subversion 等。但不同的是，git采用了分布式版本库的方式，不必服务器端软件支持。

注：版本控制系统在多人共同完成某一项目时很有用，代码同步可省却很多人力，并可方便查看哪个人在什么时候修改了什么内容。

Git 结构如下所示：

Git 安装

windows上安装：https://git-scm.com/
ubuntu上安装： $ sudo apt-get install git

Git 5分钟示例操作

示例1： github上新建repository，本地新建repository并上传到github端（详细过程可参加下一章节）

# github上创建repository: e.g., https://github.com/waerhu/HelloWorld.git
git init # 本地创建repository
git init HelloWorld # 指定本地repository目录
# 本地创建文件README.md并写入内容后
git add README.md # 上传README.md到缓存区index
git status # 查看当前缓存区index未提交到HEAD的内容
git commit -m "Adding a new file - README.md" # 提交缓存区index的内容到HEAD
git remote add origin https://github.com/waerhu/HelloWorld.git # 链接本地工作区到github上的远程库
git push -u origin master # 上传HEAD中内容到远程库
# 详细过程可参加下一章节
1
2
3
4
5
6
7
8
9
10

示例2：github上已有repository，本地从github端克隆整个项目到本地工作区，修改内容后，再提交到github。

# github已有repository: e.g., https://github.com/waerhu/HelloWorld.git
git clone https://github.com/waerhu/HelloWorld.git # 克隆github端程序到本地
# 本地修改文件README.md后
git add README.md # 上传README.md到缓存区index
git commit -m "Adding content to README.md" # 提交缓存区index的内容到HEAD
git push -u origin master # 上传HEAD中内容到远程库
1
2
3
4
5
6

Git 常见命令

1. Git 配置: 用户名和email

git config --global user.name 'runoob'  # 可自定义用户名
git config --global user.email test@runoob.com  # 可自定义email

# 可查看所有的config：
git config --list
1
2
3
4
5

3. 新建repository：

git init # 创建repository
git init newrepo # 指定repository目录为newrepo（newrepo可自定义） 
1
2

4. 提交修改（本地工作区working dir -> 缓存区index/stage）

git add README.md  # 添加单个指定文件（文件可自定义）
git add README.md newfile.txt  # 提交多个指定文件
git add *  # 提交指定目录下所有文件
1
2
3

5. 提交版本（缓存区index/stage -> HEAD）

git commit -m "note for commitment" # -m 指定注释，注释语可自定义
1

commit也可直接提交本地工作区内容到HEAD（working dir -> HEAD），即加上参数-a：

# 等同于：
# git add README.md
# git commit -m "note for commitment"
# 
git commit -am "note for commitment" # -am
1
2
3
4
5

4. 同步代码到远程库（HEAD -> Github）

git remote add origin https://github.com/waerhu/HelloWorld.git  # 链接到远端库，远端库地址可自定义

git push origin master  # 同步到远端库,推送master分支到远程库
# or
git push -u origin master # 第一次同步，需带有-u参数

# 推动另一test分支到orifin远程库
git push origin test
1
2
3
4
5
6
7
8

-u：因为远程库是空的，所以我们在第一次推送 master 分支时，要加上 -u 参数，Git不但会把本地的 master 分支内容推送的远程新的 master 分支，还会把本地的 master 分支和远程的 master 分支关联起来，在以后的推送或者拉取时就可以简化命令。

5. 从远端库clone代码（Github -> working dir）

git clone https://github.com/waerhu/HelloWorld.git # 远端库可自定义
1

6. 从远端库同步代码到本地 （Github -> working dir）

git pull origin master

# or
git fetch origin 
git reset --hard origin/master
1
2
3
4
5

7. 退回/恢复

退回/恢复缓存区代码给本地工作区（缓存区index/stage -> 工作区working dir）

git checkout -- README.md  # 文件可自定义
1

---

退回/恢复/复制HEAD代码到缓存区，或，缓存区和工作区（HEAD -> index/stage 或 HEAD -> index/stage & working dir）

# git reset 默认从HEAD复制到index
git reset
git reset -- hard # 同时copy HEAD到index和working dir
1
2
3

---

退回/恢复/复制指定文件的HEAD代码到缓存区（HEAD -> index/stage ）

# git reset 默认从HEAD复制到index,
# 等同于git reset HEAD -- README.md, 
git reset -- README.md # 文件可自定义
1
2
3

---

类似于退回HEAD内容，也可以回退HEAD上一版本（HEAD～）：
退回/恢复/复制指定文件的HEAD～代码到缓存区（HEAD～ -> index/stage & working dir）

git checkout HEAD~ -- README.md # 文件可自定义
1

---

如果在回退之前版本同时，需要回退HEAD内容，可用git reset：
退回/恢复HEAD到上3个版本（HEAD -> HEAD~3）：
注： HEAD表示当前版本，则HEAD～表示上一个版本，那么上上版本就是HEAD～～,上n个版本即为HEAD～n，如HEAD~3

# HEAD表示当前版本，则HEAD~表示上一个版本，那么上上版本就是HEAD~~,上n个版本即为HEAD~n，如HEAD~3
git reset HEAD~3 # 仅copy HEAD~给stage/index，未copy给working dir
git reset HEAD~3 --hard  #copy HEAD~给stage/index和working dir
git reset HEAD~3 --soft  #未copy HEAD~给stage/index或working dir
1
2
3
4

---

9. 查看状态

git status
# or
git status -s # 以单行显示结果
1
2
3

10. 查看log

git log
#
git log --pretty=oneline  # log 展示效果为：一条log为一行
git config format.pretty oneline # 也可直接配置config，使得每次显示历史记录时，每个提交的信息只显示一行
#
git log -3 # 查看最后三次提交记录信息
#
git reflog     #  查看历史记录的版本号id
1
2
3
4
5
6
7
8

11. 查看差异

git diff -- README.md # beteen working dir and index/stage
git diff --cached -- README.md # between index/stage and HEAD
git diff HEAD -- README.md # between working dir and HEAD

# 多个文件
git diff testdir/testfile.txt testdir/testfile.c
git diff testdir/*
1
2
3
4
5
6
7

12. 可视化查看

gitk
1

13. 分支：查看、 创建、进入、合并

git branch # 查看分支
git branch test # 创建分支test，分支名可自定义
git checkout test # 切换到test分支
# or
git checkout –b test # 创建并进入分支
#
git branch –d test # 删除分支test
#
git checkout master # 切换回master分支
git merge test # 合并test分支到主分支master
# 
git push origin test # 将test分支推送到远端仓库，不然该分支就是不为他人所见的
1
2
3
4
5
6
7
8
9
10
11
12

14. 创建 SSH KEY

ssh-keygen -t rsa -C "test@gmail.com" # email 可自定义
1

再将密钥文件cat 查看，和复制到git ssh 设置页面。

15. 查看远程库信息

git remote -v
1

16. 生成patch

git diff --binary commitID1 commitID2 > 0001-patchName.patch		# 参数--binary表示二进制文件也会添加到patch中
#
git apply --check 0001-patchName.patch # 检查patch文件是否可用，没有显示表示无冲突可直接应用
#
git apply 0001-patchName.patch # 打入patch到当前项目
1
2
3
4
5

Git 使用示例详解

1 Github 创建帐号并登录后，创建新的repository：

创建完后，生成HelloWorld repository：

2 本地git init 或者 git clone repository

因为此时远程库为空，我们通常为本地写好代码后，直接在本地创建git init repository，再更新到远程库。
当远程库已有我们代码的初版后，可通过git clone克隆到本地。

2.1 本地新建repository

使用Git前，需要先建立一个仓库(repository)。可以使用一个已经存在的目录作为Git仓库或创建一个空目录。如使用当前目录作为Git仓库，我们只需使它初始化。

git init
1

使用我们指定目录作为Git仓库。

git init HelloKitty
1

2.2 创建本地新文件

如创建README.md

cd HelloKitty/
touch READMD.md
vim README.md
# insert: i: This is a new repository, created by waerhu. Esc.
# save: :wq
1
2
3
4
5

2.3 添加本地文件到index

在创建repository后，会有一个隐藏文件夹.git，可查看该文件夹下内容：

cd .git
ls
1
2

Git的结构包括：
1）本地工作区域（即当前本地目录Working Dir），
2）缓存区（Stage或Index）：临时保存改动到一个缓存区，
3）HEAD（指向最后一次提交的结果）。

如下图所示：（History即HEAD）

可看到当前.git下有HEAD，但没有index（因为此时还没有添加内容到缓存区）。可通过git add添加文件到index，如添加README.md：

git add README.md
1

此时，再查看.git文件夹会发现已经有index。

2.4 提交index文件到HEAD

在git add后，我们的更新在缓存区index中，并未进行提交，我们可通过git status查看当前工作区内未提交的内容：

git status
1

可看到当前缓存区有我们创建的新文件README.md未提交。
提交缓存区的文件到HEAD的操作为（可在提交时添加备注信息，-m后即为备注信息）：

git commit -m "Adding a new file - README.md"
1

此时再查看缓存区index是否有未提交内容，可看到已经没有：

git status
1

注：可通过 gitk 图形化界面查看commit：

gitk
1

2.5 将HEAD中内容推送到远程库

由于此时我们的repository是本地创建的（git init），还没有链接到远程库，所以我们的链接及推送操作为：

git remote add origin https://github.com/waerhu/HelloWorld.git
1

其中的http地址即我们在github上创建的空repository地址，如第一节图所示。
如果本地的工作区是从远程库上git clone的，即不需要再次进行链接远程库。
在链接本地工作区到远程库后，可将现在已经在本地HEAD 中的改动提交到远程库：

git push -u origin master
1

此时github上的远程库已更新：

3. Git 同步远程端Github到本地

之前的操作均为，本地repository的内容提交到远程端github端。那么在多人如此操作后，我们本地的repository可能就和远程库github上不一致。

如我们在示例1后进行了示例2操作，此时github上的README.md已经变为：
但此时我们本地的repository的README.md的内容还是原来的：

注：
git status 可查看本地工作区、缓存区index和HEAD间的不一致。此时可看到本地三者之间是同步状态。
git log可查看操作的log。
在本地工作区与远程端不一致时，是无法进行提交本地内容到远程端。 Updates were rejected because the remote contains work that you do not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., ‘git pull …’) before pushing again.

将远程端github上内容同步到本地操作有：

git pull origin master
1

此时，能看到README.md内容已与github上一致。并且通过git log查看到的log也与github上同步。

此外，同步远程端github上内容到本地的命令还有：

git fetch origin 
git reset --hard origin/master
1
2

4. Git 回退操作

Git在工作时，有本地工作区（即我们的代码编辑），缓存区index（本地.git目录下）和HEAD。这导致我们在一天工作后，想将我们的修改代码提交到服务器端或github端时，需要经过重重的提交：
1）从本地工作区提交到缓存区index：git add
2）从缓存区index提交到HEAD: git commit
3）从HEAD 提交到github端: git push

而这些重重的提交实际上相当于二级缓存，在我们修改代码后或一些误操作后，很容易回退到原始状态。

示例说明如下：
当前工作区working dir， 缓存区和HEAD保存内容一致，修改并提交至：Working dir 有一些内容不在缓存区index，缓存区index有一些内容不在HEAD：

git status
vim README.md # Adding "Content in HEAD" to README.md
git add README.md
git commit -m "Adding content to HEAD"
#
vim README.md # Adding "Content in index" to README.md
git add README.md
#
vim README.md # Adding "Content in index" to README.md
#
git status
1
2
3
4
5
6
7
8
9
10
11

此时：
README.md （工作区）:

Content in HEAD
Content in index
Content in current working dir
1
2
3

README.md（缓存区index） :

Content in index
Content in current working dir
1
2

README.md （HEAD）:

Content in HEAD
1

可看到此时工作区有：

Changes to be committed
Changes to be staged for commit
1
2

为了详细看到这些Changes，我们可使用git diff命令：

1. 查看工作区与缓存区index区别：

git diff
1

2. 查看缓存区index与HEAD区别：

git diff --cached
1

3. 查看工作区与HEAD区别：

git diff HEAD
1

1. 工作区回退到缓存区index内容
   对于在本地工作区的一些修改，如README.md，在提交至缓存区index之前，可手动删除。但有时也许由于改动较多，想直接回退到缓存区内容：

git checkout --README.md
1

2) 缓存区index回退到HEAD

git reset -- README.md
1

为了查看是否回退成功，我这里将缓存区回退后的内容，再赋给工作区内容：

git status
git checkout -- README.md
cat README.md
1
2
3

3. 其实也可直接将HEAD内容赋给工作区：

git checkout HEAD -- README.md
1

5 Git 分支

创建分支，并进入分支，合并分支：

git branch test # 创建分支test
git checkout test # 切换到test分支
#
git checkout master # 切换会master分支
git merge test # 合并test分支到主分支master
1
2
3
4
5

6 删除git本地仓库

删除git本地仓库，即删除.git文件即可：默认情况下.git是隐藏文件夹。可通过如下方式查看

ls -a
1

Step 1： 删除.git:

rm -rf .git
1

确认是否删除.git文件，是否还有git相关命令：

ls -a # 没有git文件夹
git status # fatal: Not a git repository (or any parent up to mount point /media/me/nvme2n1) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
1
2

Step 2： 最后删除本地仓库的文件即可：

 rm -rf 本地仓库文件夹/
1

7 删除git远程端文件

git add 只会将新建的或者已更改的文件添加到索引区，而不会添加删除的文件
git add -u 只会去处理已修改或者已删除的文件，但是不会处理新建的文件

sudo rm test 
git add -u
git commit -m "delete test"
git push
1
2
3
4

实际问题记录

1） 发现一些文件无法上传，也无法通过git status查找到

发现在本地添加的.pcm文件无法被git status 查找到（并且无法通过git add添加），这是由于在 .gitignore 文件中设置了特定文件不进行版本管理：

cat .gitignore

# 也可根据自己需要自己创建.gitignore
touch .gitignore
1
2
3
4

如果还是想要上传，可添加 -f 参数。

2）通常的情况是，只想上传本地部分修改文件（而非全部修改文件）

假设想上传的文件是a.txt, 但b.txt也被修改过（可能还没修改完）

git status -s # 查看状态
git add a.txt

# !!! important!!!
git stash -u -k # 忽略其他文件，把现修改的隐藏起来，这样提交的时候就不会提交未被add的文件
# !!!

git commit a.txt -m "update on a.txt"
git push # 可能需要 git pull

# ！！！important！！！
git stash pop # 恢复之前忽略的文件（非常重要的一步）
# ！！！
1
2
3
4
5
6
7
8
9
10
11
12
13

3) 本地有修改，想将远程库的最新版本直接覆盖本地

ref： https://blog.csdn.net/weixin_38883338/article/details/96832802

使用git pull出错，错误如下：xxxx仅代表示例

me@2990wx:/media/me/nvme2n1/tmp$  git pull # error shown as follows:
Username for 'https://github.com': xxxx
Password for 'https://xxxx@github.com': 
remote: Enumerating objects: 23, done.
remote: Counting objects: 100% (23/23), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 12 (delta 10), reused 12 (delta 10), pack-reused 0
Unpacking objects: 100% (12/12), done.
From https://github.com/xxxx/Txxx
   8e91f1c..62e3304  master     -> origin/master
Updating 8e91f1c..62e3304
error: Your local changes to the following files would be overwritten by merge:
	xxxx.xxxx
	xxxx.xxxx
	xxxx.xxxx
Please, commit your changes or stash them before you can merge.
Aborting
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

直接覆盖操作为：

git fetch --all
git reset --hard origin
git pull
1
2
3

如果想将冲突文件保存本地更改的时候，可以将 git reset --hard 换成 git reset --soft