Git 基础

站长

2024年04月03日 22:55 · 阅读数 4

Git相关文档

Git特点

直接记录快照，而非差异的比较（与其他版本控制系统的主要差异？）
保证完整性。Git用以计算校验和的机制叫做 SHA-1 散列（hash，哈希）（SHA-1原理？）。这是一个由 40 个十六进制字符（0-9 和 a-f）组成的字符串，基于 Git 中文件的内容或目录结构计算出来。例如

// git log 命令的字符串也类似
24b9da6552252987aa493b52f8696cd6d3b00373

git一般只往数据库中添加数据（本地数据库的实现方式？）
所有操作都是本地执行的
任何已提交的操作总是可以恢复的，未提交的操作是无法恢复的

三种状态

modified 修改
staged 暂存。对已修改文件的当前版本做了标记，使之包含在下次提交的快照中
commited 存储到本地的数据库中

git配置

查询git配置

/etc/gitconfig。包含系统上每一个用户及他们仓库的通用配置。--system
~/.gitconfig ~/.config/.gitconfig 只针对当前用户。--global
当前目录的config文件.--local
git config --list --show-origin 展示当前所有的配置和来源

检查配置信息

git config --list 检查所有信息
git config user.name 检查对应的信息

设置用户信息

git config --global user.name 'xxx'
git config --global user.email 'xxx@xxx.xxx'

获取帮助

git help config git conifg --help man-git-<verb>获取详细帮助
git config -h 获取简明帮助

git仓库

git add *.c
git add LICENSE
git commit -m 'initial project version'

克隆远程仓库到本地

git clone 三种协议 https:// git:// SSH

文件状态

已跟踪
未跟踪 git add -> 未跟踪 -> 已跟踪？？？
暂存 git add 已跟踪并修改的文件 -> 暂存？？？
git status 可以查询文件状态以及当前所在分支
git status -s 输出更为紧凑的文件状态
- ?? 新添加的未跟踪文件
- M 已修改的文件
- M 已修改已暂存
- MM 有已修改已暂存的内容，也有已修改的内容
- A 新添加到暂存区的文件
git add
- 可以用它开始跟踪新文件
- 把已跟踪的文件放到暂存区
- 合并时把有冲突的文件标记为已解决状态
.gitignore 忽略文件，一个项目可以有多个ignore文件存在
git diff 比较尚未暂存的文件的改动
git diff --staged（--cached） 比较已暂存文件的改动
git commit 提交
- git commit -m 'xxx' 提交并输入提交信息
- 提交时记录的是放在暂存区域的快照，以后可以回到这个状态 git log
- git commit -a 把已跟踪的文件暂存起来并一并提交
- git commit -a -m 'xxx' git commit -am ''
git rm
- 手动删除文件时，从暂存区移除某个文件，这样就不用git add -> git commit ，可以直接git commit
- git rm -f 删除之前修改过或已经放到暂存区
- git rm --cache 把文件从git仓库中移除，并保留在当前工作区中
git mv 移动文件，对文件改名git mv fileA fileB
- mv fileA fileB
- git rm fileA
- git add fileB

git查询历史

git log
git log -p 显示每次提交所引入的差异
git log -2 显示最近两条记录
git log --stat 看到每次提交的简略统计信息，如变更行数，变更文件等
git log --pretty=oneline 格式化log日志输出为一行
git log --pretty=format:'%h %s' --author='' --since='' --before='' --no-merge
git log --no-merges <branch>..<branch> 要求 Git 只显示所有在后面分支但不在前面分支的提交的列表。 -git log branch --not master 查询没有在master上的提交
git shortlog --no-merges master --not v1.0.1
git log --abbrev-commit 为 SHA-1 值生成出简短且唯一的缩写
git log -1 --name-only --pretty=format:'' <SHA-1>找出一次提交中修改文件的文件名

撤销提交

git commit --amend 提交时忘记add某个文件，可通过git add 添加后再执行该命令，这样只会存在一个提交
git reset HEAD filename 取消暂存一个文件。本质上先移动到HEAD，然后让索引看起来像HEAD。所以它本质上只是将 file.txt 从 HEAD 复制到索引中。
- HEAD 是当前分支引用的指针，它总是指向该分支上的最后一次提交。
- git reset --soft HEAD 将HEAD移动到指定快照，指定快照之后的索引和工作目录都不改变，此时可以通过git commit 来完成 git commit --amend 所做的事。主要用于压缩提交，即合并多个本地commit为一个commit
- git reset --mixed HEAD (get reset HEAD)将HEAD移动到指定快照, 但是会取消暂存所有指定快照之前的提交内容
- git reset --hard HEAD 将HEAD移动到指定快照, 并清空所有指定快照之前的提交内容
- git reset HEAD filename 将指定文件还原为HEAD版本
- reset 和 checkout的区别
  - git checkout [branch]相对于git reset --hard [branch]是安全的。在切换分支的过程中，checkout在没有分支冲突的情况下，会把工作区及暂存区的代码同步到另一条分支上
  - reset [branch] 会移动当前HEAD的指向，即改变当前分支的提交分支，而chekcout移动的是HEAD自身来指向另一个分支
  - git checkout 文件路径类似于git reset --hard [branch] file，直接检出对应的文件覆盖工作区的文件
git checkout -- filename 还原一个文件，直接还原为数据库版本

恢复

git reflog 查询已经丢失的提交。每当head变化，Git 就会将这个信息存储到引用日志这个历史记录里。引用日志只存在于本地仓库。
git update-ref 更新引用日志（reflog）
git log -g 以标准格式输出引用日志
git branch branchname sha-1 新建名为branchname的分支指向引用为sha-1的提交
引用日志存放在 ./git/logs/ 中
git fsck --full 用于恢复没有引用日志的情况
git clone 会下载整个项目的历史，包括每一个文件的每一个版本

远程仓库信息

git remote -v 查看远程仓库地址及读写信息
git remote add shortname url 添加新的远程仓库，并给一个shortname别名
git fetch 拉取远程仓库中你没有的信息。只会拉取远程数据到本地，并不会主动合并或修改当前的工作
git pull 抓取并合并远程分支到当前分支
git clone 会自动添加远程仓库并默认以origin为简写
git fetch origin 会自动拉取上一次抓取或clone后新推送的所有工作
git push remote branch 推送到远程remote仓库的branch分支
git remote show remote 查看remote远程仓库的信息
git remote rename prename curname 重命名某个远程仓库
git remote remove/rm 移除某个远程仓库

打标签

git tag
轻量标签 git tag v1.2
附注标签 git tag -a v1.2 -m 'xx' 会保留打标签者的名字、电子邮件地址、日期时间，此外还有一个标签信息，并且可以使用 GNU Privacy Guard （GPG）签名并验证
推送到远程分支：git push tag v1.4 推送指定分支 git push origin --tags 推送远程仓库没有的本地所有分支
删除tag git tag -d tagname 本地删除推送到远程 git push origin --delete tagname
检出并创建分支 git checkout -b branchname tagname 切换到对应的tag git checkout tag

别名

内部命令设置别名：git config --global alias.customCommand 'gitCommand'
外部命令设置别名：git config --global alias.customCommand '!outsideCommand'

分支

创建分支：git branch branchName
切换分支：git checkout branchName
创建新分支并切换：git checkout -b branchName。为以上两条命令的简写。
创建分支并关联到远程分支：git checkout -b <branch> <origin/branch>
以远程分支名命名本地分支：git checkout -b --track <origin>/<branch> 。简写：git checkout <branch>
更改本地分支绑定的远程分支：git branch -u <origin>/<branch> git branch --set-upstream-to <origin>/<branch>
删除分支： git branch -d branchName 强制删除 git branch -D branchName
删除远程分支：git push origin --delete <branch>。只删除指针，git服务器通常会保留一段时间知道gc执行，所以数据很容易恢复
分支合并：git merge <branch> 切换到对应分支并执行该命令。三方合并？合并结果生成一个新的提交快照
该命令仅会显示自当前主题分支与 master 分支的共同祖先起，该分支中的工作：git diff master...branch
变基：git rebase 与merge相比，能够使分支更加整洁。先找到两个分支的共同祖先，然后对比当前分支相对于该祖先的历次提交，提取相应的修改并存为临时文件，然后将当前分支指向目标基底，最后以此将之前另存为临时文件的修改依序应用。变基操作的实质是丢弃一些现有的提交，然后相应地新建一些内容一样但实际上不同的提交。
git rebase --onto master a b b分支基于a分支创建，a分支基于master创建。此命令用于合并b分支上，不存在a分支的提交，并合并到master
git rebase master a 直接在master分支上rebase a分支
git rebase -i将工作压缩成一个单独的提交
变基准则：如果提交存在于你的仓库之外，而别人可能基于这些提交进行开发，那么不要执行变基。
git pull --rebase 等同于？ git fetch``git rebase <origin>/<master> 。使用pull 默认使用选项--rebase，git config --global pull.rebase true
总的原则是，只对尚未推送或分享给别人的本地修改执行变基操作清理历史，从不对已推送至别处的提交执行变基操作，这样，你才能享受到两种方式带来的便利。
查看当前本地分支：git branch
过滤已经合并/未合并到当前分支：git branch --merge/--no-merge
本地分支命名<branch>和远程分支命名 <remote>/<branch>
查看远程分支：git ls-remote 获得远程分支更多的信息git remote show <remote>
同步给定仓库的远程分支数据：git fetch <origin> 抓取所有仓库的数据：git fetch --al
推送：git push <remote> <branch>
避免https仓库每次提交输入密码：git config --global credential.helper cache
拉取：git pull 相当于 git fetch git merge
git show <branch> | <SHA-1>

git分支切换的原理

只记录提交的快照，变动文件的blob的对象（每个文件对应的快照），一个树对象（记录目录结构和blob对象索引），一个提交对象（包含着指向前述树对象的指针和所有提交信息）
具体原理，其他版本管理系统一般是对文件进行复制操作，git的分支实质上仅是包含所指对象校验和的对象
拣选对应的提交：git cherry-pick ecf34
rerere：首先配置 git config --global rerere.enabled true

其他

提交信息模版

提交贡献

git clone 对应的仓库
git checkout <branch> 切换分支进行开发
git remote add origin <url>
git push -u origin <branch> 将commit推送到对应仓库的分支。不需要合并到master分支，这样做的好处是当你的建议未被采纳时，你不用回滚master上的代码。
告知维护者自己的提交信息：git pull-request <origin>/<branch> <url> 获取自己的提交信息并发送给维护者
仓库维护者无法干净的合并时，可以通过变基操作，重新提交：git checkout <branch> git rebase origin/master git push -f origin branch 。
另一种方式 git checkout -b <branch> <origin>/<branch> 生成一个新分支；在新分支上合并git merge --squash <branch> git commit git push origin <branch>
邮件方式。假如现在有多个commit，可以通过git format-patch -M origin/master将每一个提交转换为一封电子邮件

邮件发送。需要在 ~/.gitconfig 文件中设置 imap 区块。然后通过git config --global imap.xxx xxx 设置

[imap]
  folder = "[Gmail]/Drafts"
  host = imaps://imap.gmail.com
  user = user@gmail.com
  pass = YX]8g76G_2^sFbd
  port = 993
  sslverify = false

执行cat *.patch |git imap-send将补丁序列放在特定 IMAP 服务器的 Drafts 文件夹中

也可以通过smtp服务发送邮件，进行如下配置

[sendemail]
  smtpencryption = tls
  smtpserver = smtp.gmail.com
  smtpuser = user@gmail.com
  smtpserverport = 587

之后就可以执行 git send-email *.patch进行补丁发送

应用补丁

git apply 应用前检查补丁：git apply --check *.patch
git am a apply m mail 包含冲突时，解决冲突，执行git add，之后执行 git am --reslove
git am -3 *.patch 以一种智能方式提交。使 Git 尝试进行三方合并。创建补丁的提交并不在你的版本库内的话，这样做是没有用处的。

好用的命令

查看

当前提交：git show 查看当前head的commit记录
上一次提交：git show HEAD^ 查看上一次commit记录等价于 git show HEAD~
前两次提交：git show HEAD~2 git show HEAD~~ ``
提交区间：存在于dev分支上不存在于master上。git log master..dev
查看即将推送到远程分支的内容： git log origin/master..HEAD 等同于 git log origin/master..
双点语法无法显示多分支的差异，可以使用：git log refa refb --not refc 或者 git log refa refb ^refc
三点：git log master...dev 如果你想看 master 或者 dev 中包含的但不是两者共有的提交。可以使用git log --left-right master...dev 可以方便的查看那个提交属于哪个分支

交互式缓存

能够帮助你对commit进行拆分合并
git add -i 类似于git status 但展示更简明扼要一些
能够暂存部分提交文件及文件中的某一部分git add -p git add --patch也可以实现该功能。git reset --patch 部分重置文件 git checkout --patch部分检出文件 git stash save --patch 部分暂存文件

贮藏与清理

保存当前工作目录并切换到其他分支 git stash或git stash push
查询储藏记录：git stash list
应用储藏记录：git stash apply 应用指定的储藏 git stash apply stash@{2}
移除暂存： git stash drop stash@{0}
更新暂存： git stash apply --index
暂存并保留在索引中：git stash --keep-index
默认情况下，git stash 只会暂存已跟踪文件。若要暂存未跟踪文件，git stash -u。但并不会包含忽略文件。git stash -a，包含忽略文件。
从储藏创建一个分支：git stash branch <new branchname>
清空目录：git clean git clean -f -d 移除工作目录中为追踪的文件及空的子目录。这个命令是不安全的，更安全的命令是git stash --all
清空目录预演：git clean -d -n
清空忽略文件：git clean -n -d -x
交互式清空： git clean -x -i

签署工作

搜索

git grep -n gmtime_r -n 输出 Git 找到的匹配行的行号
日志搜索：git log -S ZLIB_BUF_MAX --oneline -S 查询ZLIB_BUF_MAX是什么时候引入的

重写历史

git commit --amend 会改变上次提交的SHA-1 校验和，可用于修改信息及修改提交内容。如果修改了提交内容并需要反映到提交信息上，可以用这个命令。但如果只是遗漏了文件，可以使用git commit --amend --no-edit。
git rebase -i 交互式修改历史提交。注意点，commit 校验和和log显示的是相反的。修改pick改为edit。删除，直接删除对应的记录。合并，pick改为squash。拆分，修改pick为edit，执行git reset HEAD^，然后对工作区文件多次commit后执行，git rebase --continue。会改动所有在列表中的提交的 SHA-1 校验和。
核武器级选项：git-filter-repo
如果想要移除所有偶然提交的编辑器备份文件，执行：git filter-branch --tree-filter 'rm -f *~' HEAD

全局修改邮箱地址：

git filter-branch --commit-filter '
        if [ "$GIT_AUTHOR_EMAIL" = "schacon@localhost" ];
        then
                GIT_AUTHOR_NAME="Scott Chacon";
                GIT_AUTHOR_EMAIL="schacon@example.com";
                git commit-tree "$@";
        else
                git commit-tree "$@";
        fi' HEAD

高级合并

不想继续合并：git merge --abort。在工作目录中有未储藏、未提交的修改时它不能完美处理，除此之外它都工作地很好。
出于某些原因想要重来一次，执行：git reset --hard HEAD。回到上一次提交的状态。同样会丢失为提交的文件
忽略空白行修改；git merge -Xignore-space-change whitespace。-Xignore-space-change将一个空白符与多个连续的空白字符视作等价的。-Xignore-all-space完全忽略空白符修改
传递给--confilict diff3 merge 选项可以展示包含ours，thiers，base三个版本的代码。git checkout --conflict=diff3 hello.rb。可以通过设置，git config --global merge.conflictstyle diff3，来让diff3作为合并冲突的默认选项
获取合并日志：git log --oneline --left-right HEAD...MERGE_HEAD
撤销合并：撤销本地合并git reset --hard HEAD-。如果其他人已经有你要重写的提交，这种方法是无效的。
另一种方式：git revert -m 1 HEAD 。revert后，如果想继续合并，需要再revert一次git revert HEAD
单方合并，只是用我们的代码或只使用他们的代码：git merge Xours <branch> git merge Xtheirs <branch>
把一个项目作为另一个项目的子目录：git read-tree --prefix=rack/ -u rack_branch。更新代码，先切回队形仓库的分支执行git pull命令。之后切回原分支，执行git merge --squash -s recursive -Xsubtree=rack rack_branch。与原分支做比较，git diff-tree -p <branch>

Rerere

它允许你让 Git 记住解决一个块冲突的方法，这样在下一次看到相同冲突时，Git 可以为你自动地解决它。reuse recorded resolution
开启功能：git config --global rerere.enabled true
如果文件冲突之前解决过。在回滚操作之后，如果开启了rerere，则git会帮我们用上次解决方式解决冲突。git diff 查看冲突是如何解决的。恢复文件为冲突状态：git checkout --conflict=merge hello.rb。执行git rerere
如果需要经常变基，打开 rerere 功能可以帮助你的生活变得更美好 ###使用 Git 调试
查询代码每一行的提交记录git blame
使用二分法定位出错的commit：git bisect start git bitect bad git bitect good <good_commit> 在检出的commit上测试，然后执行git bisect good或git bisect bad 定位到错误后，执行git bisect reset

子模块

打包

替换

凭证存储

http访问不需要输入账号密码
git config --global credential.helper cache cache会将凭证存放在内存中一段时间
git config --global credential.helper 'store --file ~/.my-credentials' store 永久明文保存

自定义 Git

配置git

获取支持的配置列表：man git config
commit.templete git config --global commit.template ~/.gitmessage.txt 设置默认的提交模版
core.excludesfile 配置全局生效的.gitignore文件
core.autocrlf 解决多系统协作问题。true ，换行被转换成回车+换行。input ，回车+换行转换成换行。false，window开发者保留回车+换行
core.whitespace 。Git 预先设置了一些选项来探测和修正多余空白字符问题。
服务器端配置。receive.fsckObjects 娇艳推送过来文件的SHA-1。receive.denyNonFastForwards变基已推送的提交，然后推送或推送一个提交，当前远程分支当前所指向的提交不再该推送的提交中。receive.denyDeletes，禁止通过推送删除分支和标签。

Git 钩子

提交工作流钩子：

pre-commit。键入提交信息前运行。用于做提交前检查，通过git commit --no-verify可以跳过。
prepare-commit-msg 钩子在启动提交信息编辑器之前，默认信息被创建之后运行。对那些会自动产生默认信息的提交，如提交信息模板、合并提交、压缩提交和修订提交等非常实用。你可以结合提交模板来使用它，动态地插入信息。
commit-msg钩子接收一个参数，此参数即上文提到的，存有当前提交信息的临时文件的路径。。可以用来在提交通过前验证项目状态或提交信息。 -post-commit。钩子在整个提交过程完成后运行。该钩子一般用于通知之类的事情。

Git内部原理

新初始化的 .git 目录的典型结构如下：

$ ls -F1
config        包含项目特有的配置选项
description   仅供 GitWeb 程序使用，我们无需关心
HEAD          指向目前被检出的分支
（尚待创建的）index 文件    保存暂存区信息
hooks/        钩子
info/         包含一个全局性排除（global exclude）文件， 用以放置那些不希望被记录在.gitignore 文件中的忽略模式（ignored patterns
objects/      存储所有数据内容
refs/         存储指向数据（分支、远程仓库和标签等）的提交对象的指针

Git 对象

一个文件对应一个内容，以该内容加上特定头部信息一起的 SHA-1 校验和为文件命名。校验和的前两个字符用于命名子目录，余下的 38 个字符则用作文件名。
头部信息构成：对象的类型 + 空格 + 数据内容的字节数 + 空字节
创建一个文件git对象 git hash-object -w <filePath>
通过对象获取对应的文件：git cat-file -p <SHA-1>
获取文件存储的数据类型：git cat-file -t <SHA-1>
树对象，一个树对象可以包含多个对象或其他树对象。git使用树对象来解决保存文件名，也允许我们将多个文件组织到一起。git cat-file -p master^{tree} 获取某项目当前的树对象
创建暂存区：git update-index。文件模式，100644 普通文件，100755 可执行文件，12000表示一个符号链接。可以通过 git write-tree 命令将暂存区内容写入一个树对象。
创建提交对象：可以通过调用 commit-tree 命令创建一个提交对象，为此需要指定一个树对象的 SHA-1 值，以及该提交的父提交对象（如果有的话）。
标签对象，类似于一个提交对象。但是提交对象一般指向树对象，标签对象指向一个提交对象。它包含一个标签创建者信息、一个日期、一段注释信息，以及一个指针。它永远指向一个提交对象，只不过给这个提交对象加上一个更友好的名字罢了。轻量标签指向固定引用，附注标签会生一个标签对象，并用一个引用只想当前这个标签对象。

Git 引用

对仓库的一个提交感兴趣，我们需要知道对应提交的SHA-1校验和。但也可以通过refs来进行快捷访问。
git update-ref refs/heads/master 1a410efbd13591db07496601ebc7a059dd55cfe9
当运行类似于 git branch 这样的命令时，Git 实际上会运行 update-ref 命令，取得当前所在分支最新提交对应的 SHA-1 值，并将其加入你想要创建的任何新引用中。
HEAD引用。HEAD 文件通常是一个符号引用（symbolic reference），指向目前所在的分支。所谓符号引用，表示它是一个指向其他引用的指针。
查看HEAD引用值：git symbolic-ref HEAD；设置git symbolic-ref HEAD refs/heads/test
标签引用。不光可以作为标签对象的引用，也可以作为其他对象的引用。
远程引用。指向一个包含远程仓库地址和名字对象的引用，即remotes

包文件

Git 最初向磁盘中存储对象时所使用的格式被称为“松散（loose）”对象格式。但是，Git 会时不时地将多个这些对象打包成一个称为“包文件（packfile）”的二进制文件，以节省空间和提高效率。可以手动执行git gc命令后再查看.git/obejcts文件
打包后。索引文件包含了包文件的偏移信息，我们通过索引文件就可以快速定位任意一个指定对象。
查看打包对象的内容：git verify-pack .git/objects/pack/pack-978e03...
Git 时常会自动对仓库进行重新打包以节省空间。当然你也可以随时手动执行 git gc 命令来这么做。

引用规范

引用规范的格式由一个可选的 + 号和紧随其后的 : 组成，其中是一个模式（pattern），代表远程版本库中的引用；是本地跟踪的远程引用的位置。 + 号告诉 Git 即使在不能快进的情况下也要（强制）更新引用。
定义push 或 fetch 推送/拉取规则