Git 使用手册

slug: /git

sidebar_position: 1

本文主要摘录于：https://github.com/renyuns/learngit

方便我自己查找和使用，建议大家直接阅读原文。

待补充：https://blog.yanqingshan.com/52.html

常用命令

git status  #查看工作空间文件是否被修改以及暂存空间文件是否已提交

git diff    #比较工作空间与暂存空间的不同

git add 文件名 #将文件放到暂存区

git add -A #提交所有变化

git diff HEAD #查看本次提交与上次提交的不同，建议在commit前先执行该命令

git commit -m "修改内容说明"  #将暂存区文件提交到仓库的历史记录中，并说明修改了什么

git commit --amend #修改上次的提交信息

git push origin main    #将修改推送到远程仓库(origin)的 main 分支
(初次用 git push -u origin main)

git log #查看提交日志

git clone   地址 #从远程仓库下载

git pull    #从远程仓库拉取最新版本

git branch dev  #创建 dev 分支

git switch dev   #切换到 dev 分支

git branch -d dev #删除 dev 分支

git merge dev #当前分支合并 dev 分支

一、Git 和 SVN 的区别

	类型	描述
Git	分布式	本地有镜像,无网络时也可以提交到本地镜像,待到有网络时再push到服务器
SVN	集中式	无网络不可以提交, 和 Git 的主要区别是历史版本维护的位置

二、相关名词理解

工作区 (Working Directory): 自己电脑里能看到的目录
版本库 (Repository): 工作区有一个隐藏目录 .git，这个不算工作区，而是 Git 的版本库

Git 的版本库里存了很多东西，其中最重要的就是称为 stage（或者叫index）的暂存区，还有 Git 为我们自动创建的第一个分支 main，以及指向 main 的一个指针叫 HEAD

三、安装

Git 下载地址 (Linux/Unix, Mac, Windows 等相关平台)

注意: 以下所有命令都在 Git Bash 中运行，不是 cmd，拷贝命令的时候不用复制前面的 $ 符号

## Git 是分布式版本控制系统，所以每个机器都必须自报家门：你的名字和 Email 地址
## git config 命令的 --global 参数，用了这个参数，表示你这台机器上所有的 Git 仓库都会使用这个配置，当然也可以对某个仓库指定不同的用户名和 Email 地址(不加 --global)

# 配置所有 Git 仓库的 用户名 和 email 

git config --global user.name "Your Name"  // “ ”引号不包含
git config --global user.email "youremail@example.com"

# 配置当前 Git 仓库的 用户名 和 email

git config user.name "Your Name"
git config user.email "youremail@example.com"

# 查看全局配置的 用户名 和 email 

git config --global user.name     查看用户名
git config --global user.email     查看邮箱地址

# 查看当前仓库配置的 用户名 和 email 

git config user.name     查看用户名
git config user.email     查看邮箱地址

git config --global color.ui auto #可以让命令的输出拥有更高的可读性

git config --list --show-origin #查看所有的配置以及它们所在的文件

四、相关命令

$ cat <file>    # 显示文件内容,如: cat readme.txt 就是在 git bash 中显示该文件内容
$ cd ~          # 进入用户主目录

(所有命令都在 Git Bash 中运行)
$ git                           查看 git 的相关命令 (git --help)
$ git --version                 查看 git 的版本
$ git config                    查看 git config 的相关命令
$ git pull origin develop       从远程(origin) 的 develop 分支拉取代码

1. 初始化本地仓库

注: 下面所有的命令使用的时候不用拷贝最前面的 $ 符号

$ cd d:
$ mkdir learngit
$ cd learngit
$ pwd

$ git init              把当前目录初始化为 git 仓库
$ ls -ah                查看当前目录下的文件,包含隐藏文件 (不带 -ah 看不了隐藏文件)

# cd: change directory 改变目录
# mkdir  创建目录
# pwd    用于显示当前目录
注意: 为避免遇到各种奇怪的问题，确保目录名 (包括父目录) 不含中文

# 不想要 git 管理跟踪的文件,可以在仓库根目录添加 .gitignore 文件,在里面写对应的规则

2. 添加文件到仓库

git add <file>              如: git add readme.txt
git commit -m "description"     如: git commit -m "add readme.txt"

# 添加文件到仓库分两步:
# 1. add 添加该文件到暂存区, 
# 添加许多同种类型的文件,可以使用通配符 * (记得加引号)  如: git add "*.txt"  命令就是添加所有 .txt 文件

# 2. commit 提交该文件到仓库, description 为你对该次提交的描述说明, 
注意: 可以多次 add 不同的文件，commit可以一次提交多个文件

#修改上次的提交信息
git commit --amend

提交所有变化的命令对比：

git add -A   # 提交所有变化
git add -u   # 提交被修改(modified)和被删除(deleted)文件，不包括新文件(new)
git add .    # 提交新文件(new)和被修改(modified)文件，不包括被删除(deleted)文件

3. 查看仓库目前状态 (项目是否有修改、添加、未追踪的文件等)

$ git status

4. 查看修改内容，查看文件不同 (difference)

$ git diff  //查看工作区(work dict)和暂存区(stage)的区别
$ git diff <file>   //如: git diff readme.txt  表示查看 readme.txt 修改了什么,有什么不同             
$ git diff --cached  //查看暂存区(stage)和分支(main)的区别
$ git diff HEAD -- <file>  //查看工作区和版本库里面最新版本的区别

5. 查看提交日志

$ git log           #查看以当前状态为终点的历史日志
$ git log --oneline     #美化输出信息,每个记录显示为一行,显示 commit_id 前几位数
$ git log --pretty=oneline     #美化输出信息,每个记录显示为一行,显示完整的 commit_id
$ git log --graph --pretty=format:'%h -%d %s (%cr)' --abbrev-commit --
$ git log --graph --pretty=oneline --abbrev-commit

# 显示从最近到最远的提交日志
# 日志输出一大串类似 3628164...882e1e0 的是commit_id (版本号),和 SVN 不一样，Git 的commit_id 不是 1，2，3…… 递增的数字，而是一个 SHA1 计算出来的一个非常大的数字，用十六进制表示, 因为 Git 是分布式的版本控制系统，当多人在同一个版本库里工作，如果大家都用 1，2，3……作为版本号，那肯定就冲突了
# 最后一个会打印出提交的时间等, (HEAD -> main)指向的是当前的版本
# 退出查看log日志，输入字母 q (英文状态)

6. 查看命令历史 (用于版本切换)

$ git reflog   #查看当前仓库的操作日志

# 假如我们依次提交了三个版本 a->b->c，然后昨天我们从版本c回退到了版本b,今天我们又想要回到版本 c，此时就可以使用 reflog 命令来查找c版本的commit_id，然后使用reset --hard命令来进行版本回退

7. 版本回退

$ git reset --hard HEAD^
$ git reset --hard <commit_id>

# HEAD    表示当前版本，也就是最新的提交
# HEAD^   上一个版本
# HEAD^^  上上一个版本
# HEAD~100   往上100个版本

# 回退到 commit_id 对应的那个版本，commit_id 为版本号,只需要前几位就行

# 回退后要推送到远程仓库
git push -f -u origin main

8. 撤销修改

丢弃工作区 (Working Directory) 的修改

$ git restore <file>  (建议使用) (如: git restore readme.txt)
$ git checkout -- <file>
# 命令中 -- 很重要，没有就变成 “切换到另一个分支” 的命令

丢弃暂存区 (stage/index) 的修改

# 第一步: 把暂存区的修改撤销掉(unstage)，重新放回工作区
$ git restore --staged <file>

# 第二步: 撤销工作区的修改
$ git restore <file>

小结

当你改乱了工作区某个文件的内容，想直接丢弃工作区的修改时，用命令git restore <file>。

当你不但改乱了工作区某个文件的内容，还添加到了暂存区时，想丢弃修改，分两步，第一步用命令git restore --staged <file>，就回到了场景1，第二步按场景1操作。

已经提交了不合适的修改到版本库时，想要撤销本次提交，参考 版本回退 一节，不过前提是没有推送到远程库。

9. 删除文件

$ git rm <file>

# git rm <file> 相当于执行
- rm <file>
- git add <file

10. 删除已提交的文件夹

在 GitHub 上只能删除仓库，却无法删除文件夹或文件, 所以只能通过命令来解决

$ git pull origin main    # 将远程仓库里面的项目拉下来

$ git rm -r --cached .idea   # 删除 .idea 文件夹
$ git commit -m '删除.idea'  # 提交，添加操作说明

$ git push -u origin main    # 将本次更改更新到 github 项目上去

五、远程仓库

1. 创建 SSH Key

$ ssh-keygen -t rsa -C "youremail@example.com"

如：ssh-keygen -t rsa -C jiajia@example.com

# 邮件地址换成你自己的邮件地址，然后一路回车，使用默认值即可，由于这个 Key 也不是用于军事目的，所以也无需设置密码。

在用户主目录下，看看有没有.ssh目录，如果有，再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件，如果已经有了，可直接跳到下一步。如果没有，打开Shell（Windows下打开Git Bash），创建SSH Key

如果一切顺利的话，可以在用户主目录里找到.ssh目录，里面有 id_rsa 和 id_rsa.pub 两个文件，这两个就是 SSH Key 的秘钥对，id_rsa 是私钥，不能泄露出去，id_rsa.pub 是公钥，可以放心地告诉任何人。

2. 添加 SSH Key

# 复制Key用这种方式复制
$ cd ~/.ssh
$ cat id_rsa.pub

$ open ~/.ssh   (Mac 下打开存放 Github 生成的 ssh Key 文件夹)

$ pbcopy < ~/.ssh/id_rsa.pub  Mac 下拷贝生成的公钥内容

3. 关联远程仓库 (先有本地仓库)

$ git remote add origin git@github.com:renyuns/learngit.git
# 后面的地址换成自己的 GitHub 仓库地址

4. 推送到远程仓库

$ git remote       #查看远程库信息
$ git remote -v    #查看远程库详细信息
$ git remote rm origin  #删除已关联的远程库 origin
$ git push -u origin main    #第一次推送，否则不需要添加 -u 参数
$ git push origin main      #推送本地 main 分支到远程库
$ git push origin dev         #推送本地 dev 分支到远程库

# 一个本地库关联多个远程库，例如同时关联 GitHub 和 Gitee:

# 1. 先关联 GitHub 的远程库：(注意:远程库的名称叫 github，不叫 origin)
$ git remote add github git@github.com:renyun/learngit1.git

# 2. 再关联 Gitee 的远程库：(注意:远程库的名称叫 gitee，不叫 origin)
$ git remote add gitee git@gitee.com:renyun/learngit1.git

# 3. 推送到远程库
$ git push github main
$ git push gitee main

加上了-u参数，Git 不但会把本地的 main 分支内容推送到远程新的 main 分支，还会把本地的 main 分支和远程的 main 分支关联起来

5. 从远程仓库克隆 (先有远程库)

$ git clone git@github.com:renyuns/gitskills.git
# GitHub 支持多种协议,上面是 ssh 协议,还有 https 协议

一般建议先在 Github 上创建远程仓库，然后再克隆到本地使用。

六、分支

$ git branch       #查看分支列表及当前分支
$ git branch dev   #创建 dev 分支

$ git switch dev   #切换到 dev 分支  (或者 git checkout dev)
$ git switch -     #切换回上一个分支 (git checkout -)

$ git switch -c dev   #创建并切换到新的 dev 分支  (或者git checkout -b dev)
$ git switch -c dev origin/dev  #创建远程 origin 的 dev 分支到本地并切换到该分支

$ git branch -d dev   #删除 dev 分支
$ git branch -D dev   #强制删除 dev 分支

$ git merge dev       #合并 dev 分支到当前分支 (当有冲突的时候,需要先解决冲突)
$ git merge --no-ff -m "merge with no-ff" dev  #合并 dev 分支到当前分支(禁用Fast forward 合并策略)

$ git pull  拉取远程分支最新的内容
$ git branch --set-upstream-to=origin/dev dev  #指定本地 dev 分支与远程 origin/dev 分支的链接

# 为本次合并要创建一个新的commit，所以加上 -m 参数，把commit描述写进去
# 合并分支时，加上--no-ff 参数就可以用普通模式合并，合并后的历史有分支，能看出来曾经做过合并，而 fast forward 合并就看不出来曾经做过合并

$ git log --graph  #查看分支合并图
$ git log --graph --pretty=oneline --abbrev-commit

$ git stash  #保存当前工作区和暂存区的修改状态,切换到其他分支修复 bug 等工作,然后在回来继续工作
$ git stash list  #查看保存现场的列表
$ git stash pop   #恢复的同时把 stash 内容也删除
$ git stash apply  #恢复现场，stash内容并不删除
$ git stash drop   #删除 stash 内容
$ git stash apply stash@{0}  多次stash，恢复的时候，先用git stash list查看，然后恢复指定的stash
# 通常在 dev 分支开发时,需要有紧急 bug 需要马上处理,保存现在修改的文件等,先修复 bug 后再回来继续工作的情况

$ git cherry-pick <commit>  #复制一个特定的提交到当前分支(当前分支的内容需要先 commit,然后冲突的文件需要解决冲突,然后 commit)

$ git rebase  #把本地未push的分叉提交历史整理成直线(使得我们在查看历史提交的变化时更容易，因为分叉的提交需要三方对比)

七、标签

# 切换到对应的分支 branch 上,查看或者操作对应的标签 tag 
$ git tag  查看所有的标签
$ git tag <tagname>  打标签(默认标签是打在最新提交的commit上) 如: git tag v1.0
$ git tag <tagname> <commit_id>  给对应的 commit_id 打标签
$ git tag -a <tagname> -m "标签说明信息" <commit_id> 创建带有说明的标签，用-a指定标签名，-m指定说明文字
$ git tag -d <tagname> 删除一个本地标签
$ git push origin :refs/tags/<tagname>可以删除一个远程标签
$ git show <tagname>  查看标签信息

$ git push origin <tagname>  推送一个本地标签到远程
$ git push origin --tags     一次性推送全部尚未推送到远程的本地标签

# 删除远程标签,需要先删除本地标签,然后在删除远程标签,如:删除标签 v0.9
$ git tag -d v0.9
$ git push origin :refs/tags/v0.9