Git 笔记

1. 配置 #

git 的全局配置文件是用户目录下的 .gitconfig 文件。设置用户信息：

git config [--global] user.name "[name]"
git config [--global] user.email "[email address]"

2. 创建新仓库 #

在当前目录下创建新仓库 git init
克隆远程服务器上的仓库 git clone [url]

创建新仓库时会生成 .git 文件夹，包含了该仓库的所有配置文件。

3. 工作流 #

源码目录称为工作区 workspace ,本地仓库叫做 Repository ，远程仓库叫做 Remote ，在本地仓库和工作区之间存在一个暂存区 Index 。通常的工作流程是修改源码、放入暂存区、提交到仓库、推送到远程服务器：

4. 添加 add #

添加当前目录的所有文件到暂存区 git add .
添加指定文件到暂存区 git add [file1] [file2] ...
添加指定目录到暂存区，包括子目录 git add [dir]

5. 删除 delete #

删除工作区文件，并且将这次删除放入暂存区 git rm [file1] [file2] ...
停止追踪指定文件，但该文件会保留在工作区 git rm --cached [file]
改名文件，并且将这个改名放入暂存区 git mv [file-original] [file-renamed]

6. 提交 commit #

提交暂存区到仓库区 git commit -m [message]
提交暂存区的指定文件到仓库区 git commit [file1] [file2] ... -m [message]
提交工作区自上次commit之后的变化，直接到仓库区 git commit -a
提交时显示所有diff信息 git commit -v
使用一次新的commit，替代上一次提交，如果代码没有任何新变化，则用来改写上一次commit的提交信息 git commit --amend -m [message]

commit 之后，就会在 git 记录中形成一个新的版本。

7. 查看信息 #

显示工作区中有变更的文件 git status
显示当前分支的版本历史 git log
显示版本历史，以及每次 commit 发生变更的文件 git log --stat
显示某次提交的元数据和内容变化 git show [commit]
显示某次提交发生变化的文件 git show --name-only [commit]
显示某次提交时，某个文件的内容 git show [commit]:[filename]
显示工作区相对暂存区的差异 git diff
显示工作区相对暂存区，那些文件文件被改动了 git diff --stat
显示暂存区相对上一个commit的差异 git diff --cached [file]
显示工作区相对当前分支最新commit之间的差异 git diff HEAD
显示两个分支之间的差异 git diff [commit] [commit]
显示两个分支之间的差异 git diff [first-branch] [second-branch]

8. 回退 #

恢复暂存区的指定文件到工作区 git checkout [file]
恢复某个commit的指定文件到工作区 git checkout [commit] [file]
恢复上一个commit的所有文件到工作区 git checkout .
重置暂存区的指定文件到上一次commit保持一致，但工作区不变 git reset [file]
重置当期分支的 HARD 、暂存区、工作区到指定的 commit git reset --hard [commit]
重置当前分支的 HARD、暂存区到指定的 commit ，但工作区不变 git reset –soft [commit]

9. 远程同步 #

上传本地指定分支到远程仓库 git push [remote] [branch]
下载远程仓库的所有变动 git fetch [remote]

10. 补丁 #

将 git diff 输出的信息保存到文件，就是一个标准补丁，要生成 git 专用补丁，需要 git format-patch 命令：

将最后一个 commit 生成补丁 git format-patch -1
将最后两个 commit 分别生成补丁 git format-patch -2

用 git apply 应用补丁文件，它只会修改工作区，还要手动提交：

应用一个 git 补丁并检查是否成功 git apply --check [patch file]

11. 版本号 #

版本号以小写字母 v 开头，格式是：主版本号.次版本号-修订版本号-SHA 。

大的功能变更升级主版本号，小的功能变更升级次版本号，正式发布前的主版本号可以是 0 ，这样第一次发布时的版本号就是 v1.0。修订版本号不涉及功能更新，它是指上次标记主次版本号之后的修复 Bug 次数。每次重新标记主次版本号之后，修订版本号重置。SHA 是本次 commit 的 SHA 值的前几位

主版本号和次版本号需要用 git tag 标记，而修订次数和 SHA 可以由 git 自动记录。举例，一次本地 commit 之后，使用 git tag 为本次提交标记版本号：

$ git log
commit d3b0c251d0546194659a7a121f6404b9e28b1229
Author: lishaocheng <lishaocheng@*.com.cn>
Date:   Fri Nov 18 15:42:49 2016 +0800

v1.0 release

$ git tag -a v1.0 -m "v1.0 release"

查看当前版本号：

$ git describe
v1.0
$ git describe --long
v1.0-0-gd3b0c25

第一次发布，没有修订，所以修订版本号为 0 。SHA 中的 g 是 git 的缩写，后面本次 commit 的 SHA 值前几位。推送时使用 –tags 带上所有的本地标签：

$ git push --tags origin master
Counting objects: 9, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (7/7), done.
Writing objects: 100% (9/9), 445.64 KiB | 0 bytes/s, done.
Total 9 (delta 0), reused 0 (delta 0)
To 192.168.5.253:lishaocheng/ftp_transfer.git
   95105d6..d3b0c25  master -> master
 * [new tag]         v1.0 -> v1.0

如果发现了 Bug ，需要修改，就 clone 到本地，修改后 commit ，然后查看版本号：

$ git describe
v1.0-1-g740c0c4

修订版本号变成了 1 ，SHA 变成了本次的 commit 。然后推送：

$ git push --tags origin master

12. 使用SSH Key #

在客户端执行如下命令生成一个密钥对：

ssh-keygen -t ed25519 -C "lishaocheng_20220201"

-t 选项指定了加密类型，我们选择 ed25519 ，也可以选择其他类型。
-C 选项是设置密钥对的注释，我习惯设置用户名和日期。

设置一个便于记忆的文件名，密码可以跳过，生成的密钥对文件位于当前目录下，后缀为 .pub 的文件是公钥，另一个是私钥，把两个文件复制到 ~/.ssh/ 目录下，把公钥文件的内容添加到 git 服务器。

没次使用 git 前，需要添加key 。

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

手动添加 key 比较麻烦，可以将这个过程写入 ssh 的配置文件。新建一个配置文件：

touch ~/.ssh/config

添加如下内容：

Host 192.168.0.202
  Hostname 192.168.0.202
  Port 3022
  User lishaocheng
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/lishaocheng_20220201

Host 是服务器的名称，可用任意字符串，这里设置为服务器 IP
Hostname 必须设置为服务器 IP 或者域名
Port 是服务器 SSH 的端口
User 是用户名
PreferredAuthentications 设为公钥验证
IdentityFile 设置私钥文件的路径

之后使用 git 的时候，就不用手动添加 key 了。