Git 学习笔记一（Git - Book官方文档学习）

喜欢ヅ旅行 2023-06-03 15:52 20阅读 0赞

#### Git 学习笔记一（Git - Book官方文档学习） ####

参考：[Git - Book][]

--------------------

一、Git - Book

*  1. 起步
 *  2. Git基础
 *  3. Git 分支
 *  4. 服务器上的 Git
 *  5. 分布式 Git
 *  6. GitHub
 *  7. Git 工具
 *  8. 自定义 Git
 *  9. Git 与其他系统
 *  10. Git 内部原理
 *  A1. 附录 A: 其它环境中的 Git
 *  A2. 附录 B: 将 Git 嵌入你的应用
 *  A3. 附录 C: Git 命令

#### 一、Git - Book ####

##### 1. 起步 #####

1.1 版本控制

版本控制是一种记录一个或若干文件内容变化，以便将来查阅特定版本修订情况的系统。

1.2 Git 特点：

*  直接记录快照，而非差异比较
 *  近乎所有操作都是本地执行
 *  Git 保证完整性
 *  Git 一般只添加数据
 *  三种状态（已提交（committed）、已修改（modified）和已暂存（staged）分别对应Git 仓库、工作目录以及暂存区域）

1.3 基本的 Git 工作流程如下：

*  在工作目录中修改文件。
 *  暂存文件，将文件的快照放入暂存区域。
 *  提交更新，找到暂存区域的文件，将快照永久性存储到 Git 仓库目录。

1.4 配置

Git自带一个 git config 的工具来帮助设置控制 Git 外观和行为的配置变量 这些变量存储在三个不同的位置：

*  /etc/gitconfig 文件: 包含系统上每一个用户及他们仓库的通用配置。 如果使用带有 --system 选项的 git config 时，它会从此文件读写配置变量。
 *  ~/.gitconfig 或 ~/.config/git/config 文件：只针对当前用户。 可以传递 --global 选项让 Git 读写此文件。
 *  当前使用仓库的 Git 目录中的 config 文件（就是 .git/config）：针对该仓库。

**用户信息**

$ git config --global user.name "John Doe"
    $ git config --global user.email johndoe@example.com

**文本编辑器**

$ git config --global core.editor emacs/vim

**检查配置信息**

# 检查所有配置
    git config --list
    
    # 检查 Git 的某一项配置
    git config <key>/user.name

**获取帮助**

$ git help <verb>
    $ git <verb> --help
    $ man git-<verb>

##### 2. Git基础 #####

2.1 基本命令

# 初始化仓库
    $ git init
    
    # 添加内容到下一次提交中
    $ git add *.c
    $ git add LICENSE
    
    # 提交更新
    $ git commit -m 'initial project version'
    # 跳过使用暂存区域,跳过 git add 步骤直接提交
    $ git commit -a -m 'added new benchmarks'
    
    # 克隆仓库
    $ git clone [url] [localname]
    
    # 添加远程仓库
    $ git remote add origin [URL]
    
    # 检查当前文件状态
    $ git status
    
    # 状态简览
    $ git status -s
    $ git status --short
    
    # ?? 新添加的未跟踪文件前面
    # A 新添加到暂存区中的文件前面
    # M 修改过的文件前面
    
    # 忽略文件
    .gitignore
    
    # 显示尚未暂存的改动
    $ git diff
    
    # 查看已暂存的将要添加到下次提交里的内容
    $ git diff --cached
    $ git diff --staged
    
    # 移除文件
    # 如果删除之前修改过并且已经放到暂存区域的话，则必须要用强制删除选项 -f
    $ git rm ***
    
    # 从 Git 仓库中删除（亦即从暂存区域移除），但仍然希望保留在当前工作目录中
    $ git rm --cached README
    
    # 移动文件
    $ git mv file_from file_to

2.2 查看提交历史

$ git log
    
    # -p 用来显示每次提交的内容差异 
    # -2 来仅显示最近两次提交
    $ git log -p -2
    
    # 查看每次提交的简略的统计信息
    $ git log --stat
    
    # 指定使用不同于默认格式的方式展示提交历史
    $ git log --pretty=oneline/short/full/fuller

2.3 撤销操作

# 漏掉了几个文件没有添加，或者提交信息写错了，重新提交
    # 第二次提交将代替第一次提交的结果
    $ git commit --amend
    
    # 取消暂存的文件
    $ git reset HEAD <file>...
    
    # 撤消对文件的修改
    $ git checkout -- <file>...

2.4 远程仓库的使用

# 查看远程仓库
    # 选项 -v，会显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL
    $ git remote
    
    # 添加远程仓库
    $ git remote add origin https://github.com/***
    
    # 从远程仓库中抓取与拉取
    $ git fetch [remote-name]
    # git fetch 命令会将数据拉取到你的本地仓库——它并不会自动合并或修改你当前的工作
    # git pull 命令来自动的抓取然后合并远程分支到当前分支
    
    # 推送到远程仓库
    $ git push origin master
    
    # 查看某个远程仓库
    $ git remote show [remote-name]
    
    # 远程仓库的移除与重命名
    $ git remote rename old_name new_name
    $ git remote rm [remote-name]

2.5 打标签

Git 可以给历史中的某一个提交打上标签，以示重要。 比较有代表性的是人们会使用这个功能来标记发布结点（v1.0 等等）。

# 列出标签
    $ git tag
    
    # 创建标签
    # 通常建议创建附注标签，临时的标签，或者因为某些原因不想要保存那些信息，轻量标签也是可用的。
    
    # 附注标签
    $ git tag -a v1.4 -m "my version 1.4"
    # 看到标签信息与对应的提交信息
    # 输出显示了打标签者的信息、打标签的日期时间、附注信息，然后显示具体的提交信息
    $ git show v1.4
    
    # 轻量标签
    $ git tag v1.4-lw
    # 只会显示出提交信息
    $ git show v1.4-lw
    
    # 后期打标签
    $ git tag -a v1.2 9fceb02
    
    # 共享标签
    # 默认情况下，git push 命令并不会传送标签到远程仓库服务器上。
    # 推送单个标签
    $ git push origin [tagname]
    # 把所有不在远程仓库服务器上的标签全部传送到那里
    $ git push origin --tags
    
    # 删除本地仓库标签
    $ git tag -d <tagname>
    # 更新远程仓库
    $ git push <remote> :refs/tags/<tagname>
    
    # 检出标签，查看某个标签所指向的文件版本
    # 这会使你的仓库处于“分离头指针（detacthed HEAD）”状态，慎用，提交会出问题
    $ git checkout 2.0.0

2.6 Git 别名

# 当要输入 git commit 时，只需要输入 git ci
    $ git config --global alias.ci commit
    # 执行外部命令，可以在命令前面加入 ! 符号
    $ git config --global alias.visual '!gitk'

#### 3. Git 分支 ####

使用分支意味着你可以把你的工作从开发主线上分离开来，以免影响开发主线。

3.1 基本操作

# 查看当前分支
    $ git branch
    
    # 查看每一个分支的最后一次提交
    $ git branch -v
    
    # 查看哪些分支已经合并到当前分支
    $ git branch --merged
    # 查看所有包含未合并工作的分支
    $ git branch --no-merged
    
    # 创建分支
    $ git branch [branch-name]
    # 分支切换
    $ git checkout [branch-name]
    
    # 创建并切换到新分支
    $ git checkout -b [branch-name]
    
    # 删除分支
    $ git branch -d [branch-name]
    
    # 查看各个分支当前所指的对象
    $ git log --oneline --decorate
    
    # 查看分叉历史，输出提交历史、各个分支的指向以及项目的分支分叉情况
    $ git log --oneline --decorate --graph --all
    
    # 合并分支
    # 切换到需要合并到的分支
    $ git checkout master
    # 操作被合并的分支
    $ git merge dev
    
    # 没有冲突则直接“快进”，有冲突则需要手动解决
    # 使用 git status 命令来查看那些因包含合并冲突而处于未合并（unmerged）状态的文件，然后解决冲突再git commit
    
    # 也可以启动一个合适的可视化合并工具，一步一步解决冲突
    $ git mergetool

3.2 分支开发工作流

*  长期分支

比如只在 master 分支上保留完全稳定的代码——有可能仅仅是已经发布或即将发布的代码。 他们还有一些名为 develop 或者 next 的平行分支，被用来做后续开发或者测试稳定性

*  特性分支

特性分支是一种短期分支，它被用来实现单一特性或其相关工作。“阅后即焚”。

3.3 远程分支

# 显式地获得远程引用的完整列表
    $ git ls-remote (remote)
    # 获得远程分支的更多信息
    $ git remote show (remote) 
    
    # 更新远程仓库到本地，从中抓取本地没有的数据，并且更新本地数据库，移动 origin/master 指针指向新的、更新后的位置。
    $ git fetch origin 
    
    # 推送
    $ git push (remote) (branch)
    
    # 将本地的 serverfix 分支推送到远程仓库上的 awesomebranch 分支
    $ git push origin serverfix:awesomebranch
    
    # 跟踪分支
    $ git checkout -b [branch] [remotename]/[branch]
    # 当前分支跟踪远程分支
    $ git checkout --track origin/[branch]
    
    # 查看设置的所有跟踪分支
    # 会将所有的本地分支列出来并且包含更多的信息，如每一个分支正在跟踪哪个远程分支与本地分支是否是领先、落后或是都有。
    $ git branch -vv
    
    # 拉取
    $ git pull
    # 在大多数情况下它的含义是一个 git fetch 紧接着一个 git merge 命令
    
    # 删除远程分支
    $ git push origin --delete [branch-name]

3.4 变基

在 Git 中整合来自不同分支的修改主要有两种方法：merge 以及 rebase。变基是将一系列提交按照原有次序依次应用到另一分支上，而合并是把最终结果合在一起。

使用 rebase 命令将提交到某一分支上的所有修改都移至另一分支上，就好像“重新播放”一样。

一般我们这样做的目的是为了确保在向远程分支推送时能保持提交历史的整洁——例如向某个其他人维护的项目贡献代码时。

$ git checkout experiment
    $ git rebase master
    # 现在回到 master 分支，进行一次快进合并。
    $ git checkout master
    $ git merge experiment
    
    # “取出 client 分支，找出处于 client 分支和 server 分支的共同祖先之后的修改，然后把它们在 master 分支上重放一遍”
    $ git rebase --onto master server client
    $ git checkout master
    $ git merge client
    
    # 一般变基流程
    # git rebase [basebranch] [topicbranch]
    $ git rebase master server
    $ git checkout master
    $ git merge server

变基的风险：**不要对在你的仓库外有副本的分支执行变基。**

##### 4. 服务器上的 Git #####

本地协议（Local），HTTP 协议，SSH（Secure Shell）协议及 Git 协议

4.1 在服务器上搭建 Git

4.2 生成 SSH 公钥

# 确认自己是否已拥有密钥
    $ cd ~/.ssh
    $ ls
    authorized_keys2  id_dsa       known_hosts
    config            id_dsa.pub
    
    # 如果有id_dsa 或 id_rsa 命名的文件，其中一个带有 .pub 扩展名。 （.pub 文件是你的公钥，另一个则是私钥。），没有的话就需要创建。

[使用 SSH 连接到 GitHub - GitHub 帮助][SSH _ GitHub - GitHub]

4.3 GitLab

##### 5. 分布式 Git #####

5.1 分布式工作流程

*  集中式工作流

一个中心集线器，或者说仓库，可以接受代码，所有人将自己的工作与之同步。

*  集成管理者工作流

每个开发者拥有自己仓库的写权限和其他所有人仓库的读权限。

*  司令官与副官工作流

被称为副官（lieutenant）的各个集成管理者分别负责集成项目中的特定部分。 所有这些副官头上还有一位称为司令官（dictator）的总集成管理者负责统筹。 司令官维护的仓库作为参考仓库，为所有协作者提供他们需要拉取的项目代码。

5.2 向一个项目贡献

影响因素包括活跃贡献者的数量、选择的工作流程、提交权限与可能包含的外部贡献方法。

*  提交准则

不会想要把空白错误（根据 git help diff 的描述，结合下面给出的图片，空白错误是指行尾的空格、Tab 制表符，和行首空格后跟 Tab 制表符的行为）提交上去。

尝试让每一个提交成为一个逻辑上的独立变更集。

提交信息。

5.3 维护项目

*  在特性分支中工作
 *  应用来自邮件的补丁
 *  使用 apply 命令应用补丁
 *  使用 am 命令应用补丁
 *  检出远程分支
 *  确定引入了哪些东西
 *  将贡献的工作整合进来
 *  合并工作流
 *  大项目合并工作流
 *  变基与拣选工作流
 *  为发布打标签
 *  生成一个构建号
 *  准备一次发布
 *  制作提交简报

##### 6. GitHub #####

6.1 账户的创建和配置

6.2 对项目做出贡献

流程通常如下：

*  从 master 分支中创建一个新分支
 *  提交一些修改来改进项目
 *  将这个分支推送到 GitHub 上
 *  创建一个合并请求
 *  讨论，根据实际情况继续修改
 *  项目的拥有者合并或关闭你的合并请求

6.3 维护项目

6.4 管理组织

##### 7. Git 工具 #####

##### 8. 自定义 Git #####

##### 9. Git 与其他系统 #####

##### 10. Git 内部原理 #####

##### A1. 附录 A: 其它环境中的 Git #####