Git

git 仓库	暂存区	工作目录
用于存放提交记录	临时存放变动文件	被 Git 管理的项目目录

基础

shell

# 初始化git仓库
git init

补充：git init 会在项目根目录下创建一个.git子目录，用来保存版本信息

shell

git 命令 -h # 简略
git 命令 --help #详细

shell

# 查看git历史
history
# 搜索关键字
history | grep <keyword>

shell

# 提交暂存区文件（当前目录极其子孙）
git add .
# 添加到暂存区(整个项目文件,不管当前路径)
git add --all # -A
# 提交修改文件
git add -u

status - 状态

shell

# 查看文件状态
git status
git status -s # 简短
git status --ignored # 包括忽略文件

branch - 分支命令

主分支（master）：第一次向 git 仓库中提交更新记录时自动产生的一个分支。

开发分支（develop）：作为开发的分支，基于 master 分支创建。

功能分支（feature）：作为开发具体功能的分支，基于开发分支创建

功能分支 -> 开发分支 -> 主分支

shell

# 查看分支
git branch    # 本地
git branch -r # 远程
git branch -a # 所有（包括远端）
git branch -v # 显示分支提交信息
git branch -vv # 包括远程分支信息

shell

# 创建分支
git branch <branch_name>

# 分支改名
git branch -m old new
git branch -m new # 当前分支改名

# 切换分支
git checkout 分支名称

# 拉取远程分支并创建本地分支
git checkout -b dev origin/dev  # 获取远程dev分支，在本地起名为dev分支，并切换到本地的dev分支
git fecth origin dev:dev # 获取远程dev分支到本地dev分支 - 需要手动切换到本地dev

# 删除远程分支
git push origin --delete 分支名称 # --delete 简写 -d

shell

# 查看已合并分支
git branch --merged
# 查看未合并分支
git branch --no-merged
# 删除分支（分支被合并后才允许删除）
git branch -d <branch_name>
# 强制删除分支
git branch -D <branch_name>

log - 版本历史

log

shell

# 查看历史记录
git log
# 简洁历史记录
git log --oneline
git log --pretty=online # 会完全显示id
# 倒序查看
git log --reverse
# 对比查看
git log -p
# 最近num次提交
git log -<num>
# 文件变化
git log --name-only
# 文件状态（A | M）
git log --name-status

shell

# 范围 f5f630a和HEAD 之间记录
git log f5f630a..HEAD
# 查看文件变化的记录
git log a.js

shell

# 查看上一次提交
git log -n1 -p
# 等效写法
git show

# 查看某次提交的代码变化
git show <commitHashId>

git log 运行过程

查找HEAD指针对应的分支（假设为 master）
找到master指针指向的快照
找到父节点（前一个快照）
以此类推，显示当前分支的所有快照

reflog

可以查看所有分支的所有操作记录（包括被删除的 commit 记录和 reset 的操作）

shell

git relog

commit - 提交

shell

# 向仓库中提交代码
git commit -m 提交信息
git commit -m 添加readme

# 合并 add + commit - 修改+删除文件，不含添加文件
git commit -a -m 提交信息
git commit -am 提交信息

# 修改提交信息 && 合并提交
git commit --amend # 修改提交信息（会提交缓存区代码）
git commit --amend -m 'xx'# 直接修改提交信息（会提交缓存区代码）
git commit --amend --only # 只改提交信息
git commit --amend --only -m 'xx'

push - 推送

git push ：将本地变更上传

shell

# 添加别名
git remote add <remote_alias> <remote_url>
# 记住本次推送的分支和别名
git push -u <remote_alias> <branch_name>
git push --set-upstream <remote_alias> <branch_name>
# 推送仓库
git push <remote_url> <branch_name>
git push <remote_alias> <branch_name> #需先取别名
git push # 需先记住地址

不带参数，与push.default有关

bash

git push origin --tags # 推送所有本地tag到远程

stash - 临时存储区

暂时提取分支上所有的改动并存储，让开发人员得到一个干净的工作副本，临时转向其他工作。

默认情况

添加到暂存区的修改（staged changes）
Git 跟踪的但并未添加到暂存区的修改（unstaged changes）不会缓存
在工作目录中新的文件（untracked files）
被忽略的文件（ignored files）

使用-u 或者--include-untracked 可以 stash untracked 文件使用-a 或者--all 命令可以 stash 当前目录下的所有修改

shell

# 暂存区文件添加至临时存储区
git stash
# 添加描述
git stash save <note>
# 临时存储区列表
git stash list
# 查看临时存储区文件区别
git stash show
git stash show stash@{0}
git stash show --patch # 简写 -p，更详细信息

shell

# 恢复临时存储区（删除记录）
git stash pop
# 恢复临时存储区（不删除记录）
git stash apply stash@{0} # 旧写法
git stash apply n
# 删除临时存储区
git stash drop
# 清空临时存储区
git stash clear

恢复的时候注意当前分支是否为当初保存的分支

shell

# 从stash 新建 分支
git stash branch new_banch

# 将0记录提出，并新建分支（不删除记录）
git stash branch demo 0

自定义 statsh

作用：创建了一个记录，但当前修改或删除的文件并未从工作区移除

正常 stash，创建记录并清空工作区，方便切换分支

shell

git stash create
# 09eb9a97ad632d0825be1ece361936d1d0bdb5c7
git stash store 09eb9a97ad632d0825be1ece361936d1d0bdb5c7
git stash list
# stash@{0}: Created via "git stash store".

stash 单个文件

bash

git stash push index.js
git stash push -m "test" index.js

config - 配置

shell

# 配置全局姓名和邮箱
git config --global user.name <user_name>
git config --global user.email <user_email>

# 配置局部姓名和邮箱
git config user.name <user_name>
git config user.email <user_email>

# 为命令取别名
git config alias.a add

# 查看所有配置
git config --list
# 查看局部配置
git config --local --list
# 查看全局配置
git config --global --list

shell

# 全局配置文件
cd # 进入家目录
subl .gitconfig
# 或者
subl ~/.gitconfig

# 局部配置文件
subl .git/config

.gitignore：不需要被 git 管理的文件名字添加到此文件中，在执行 git 命令的时候，git 就会忽略这些文件

shell

*.txt
!a.txt
/vendor/**/*.txt

remote - 远端操作

git remote

shell

# 查看远程仓库别名
git remote -v
# 远端分支详情
git remote origin show
# 移除远端地址
git remote remove <alias_name> # 简写 rm
# 添加远端地址
git remote add <alias_name> <remote_url>
# 修改远端地址
git remote set-url origin <remote_url>
# 更新远端分支
git remote update origin --prune
git remote update origin -p

fetch - 拉取

git fetch

远程下载本地缺失
更新远程分支指针
不会更改本地仓库状态，pull拉取下来后会自动和本地分支合并

命令	作用
`git fetch origin master:temp`	拉取远端分支`master`并新建分支`temp`

merge - 合并分支

两个分支时会产生一个特殊的提交记录，它有两个父节点

默认：fast-farward merge合并方式，会直接将 Master分支指向 Develop 分支
--squash ：合并时将 commit 压缩为 1 个
--no-ff ：执行正常合并，在 Master分支上生成一个新节点，保证版本演进更清晰
--no-edit：没有冲突的情况下合并，自动生成说明文字并提交（Merge branch 'test'）

压缩一个：将多个 commit 整合，然后通过 commit 手动提交一次

shell

git merge --squash
git merge --no-ff
git merge --no-edit

部分记录合并：指定提交（commit）应用于其他分支

shell

git cherry-pick <commitHash>

rebase - 变基

变基：replace base

应用场景

分支合并：将分支冲突处理交由分支开发者
合并多次 commits：

分支合并

合并冲突：从 master 分支新建分支，并且 master 分支由新的提交记录，此时新建分支还指向旧的 master。

rebase：将分支出发点从旧 master 移动到新 master。

将提交记录变为线性
传统合并，master 并分支新分支，合并冲突由 master 处理。
通过新分支 rebase，可以将冲突，交由 分支开发者处理。

如果 master 分支没有新记录，此时合并只会移动指针（fast-forward）

shell

git rebase branch_name

合并 commits

当 commits 过多

不利于代码 review
造成分支污染

例子：合并 commits

合并最近 4 次提交记录

bash

git rebase -i HEAD~4

此时，会进入 vi 编辑模式

bash

p cacc52da add: qrcode
s f072ef48 update: indexeddb hack
s 4e84901a feat: add indexedDB floder
s 8f33126c feat: add test2.js

# Rebase 5f2452b2..8f33126c onto 5f2452b2 (4 commands)
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
# d, drop = remove commit

注意：不要合并先前提交的东西

bash

s cacc52da add: qrcode
s f072ef48 update: indexeddb hack
s 4e84901a feat: add indexedDB floder
p 8f33126c feat: add test2.js

这样会报错 error: cannot 'squash' without a previous commit

异常退出了 vi 窗口

bash

git rebase --edit-todo

修改完成并提交后

bash

git rebase --continue

查看结果

bash

git log

此时 3 个 commit 合并为 1 个 commit

参考链接

彻底搞懂 Git-Rebase

pull - 拉取

fetch 和 merge的合并写法，fetch更新远程状态，merge更新状态和本地合并。

shell

# fetch  + merge
git fecth origin ask:temp # 拉取远端mask到本地temp分支
git diff temp # 查看ask 和 temp 差别
git merge temp # 将temp合并到ask
git branch -d temp # 删除temp分支
# pull
git pull origin ask:ask # 将远程ask请求到本地ask

checkout - 切换分支 | 还原

切换分支，或从历史还原部分文件

shell

# 切换并创建
git checkout -b daily/0.0.1

# 利用缓存区文件覆盖物理文件
git checkout 文件

# 创建新分支（没有历史记录）
git checkout --orphan new_branch

# 交互式比较分支
git checkout -p other_branch

shell

# 从本地库 HEAD 检出 demo.html 覆盖 当前工作区
git checkout HEAD demo.html
# 还原多个文件
git checkout 90...ceb E:\\**\\src\\assets\\*.png # 支持通配符
# 将某个版本文件夹还原
git checkout 90...ceb E:\\**\\src\\views\\exception
git checkout 90...ceb src/views/auth-demo  # 相对路径

HEAD（也可以是提交 ID、分支名、Tag 名）。省略 HEAD，从暂存区检出。

reset - 重设

当前分支重设（reset）到指定的 <commit> 或者 HEAD

--mixed：默认，保留文件内容，回退提交历史
--soft：暂存区和工作区中的内容不作任何改变，HEAD 指针回退
--hard ：工作区和 HEAD 指针都回退

shell

git reset --mixed <commit>
git reset --soft <commit>
git reset --hard <commit>

revert - 撤销

撤销某次操作，此次操作之前和之后的 commit 和 history 都会保留，并且把这次撤销作为一次最新的提交

shell

git revert HEAD
# 撤销前一次 提交
git revert HEAD --no-edit
# 撤销多次操作（不会每次都提交，最终提交一次）
git revert -n HEAD

cherry-pick - 筛选

将代码从一个分支转移到另一个分支

方法一：需要另一个分支的所有代码变动，采用合并（git merge）

方法二：只需要部分代码变动，采用 cherry-pick

基本用法

bash

# commitHash作用于当前分支
git cherry-pick <commitHash>
# 参数也可以是分支名
git cherry-pick <branchName>

例子

bash

    a - b - c - d   Master
         \
           e - f - g Feature

bash

# 切换到 master 分支
git checkout master

# Cherry pick 操作
git cherry-pick f

bash

    a - b - c - d - f   Master
         \
           e - f - g Feature

git cherry-pick 命令的参数，不一定是提交的哈希值，分支名也是可以的，表示转移该分支的最新提交

bash

git cherry-pick feature

转移多个提交

bash

# 转移 HashA HashB
git cherry-pick <HashA> <HashB>
# 转移 A 到 B （不包含A）
git cherry-pick A..B
# 转移 A 到 B
git cherry-pick A^..B

配置项

git cherry-pick 常用配置

(1) -e，--edit

打开外部编辑器，编辑提交信息

(2) -n，--no-commit

只更新工作区和暂存区，不产生新的提交

(3) -x

在提交信息的末尾追加一行(cherry picked from commit ...)

(4) -s，--signoff

在提交信息的末尾追加一行操作者的签名，表示是谁进行了这个操作

(5) -m parent-number，--mainline parent-number

场景：当节点为合并节点，cherry-pick 会失败

原因：不知道采用哪个分支变动

bash

git cherry-pick -m 1 <commitHash>

参数parent-number是一个从1开始的整数，代表原始提交的父分支编号

一般来说，1 号父分支是接受变动的分支（the branch being merged into），2 号父分支是作为变动来源的分支（the branch being merged from）

代码冲突

代码冲突，cherry-pick 会暂停。

(1) --continue

用户解决冲突
添加暂存区
git cherry-pick --continue

(2) --abort：放弃合并，还原

(3) --quit：放弃合并

转移到另一个代码库

步骤：

先将仓库加为远程仓库

bash

git remote add target git://gitUrl

远程代码抓取到本地

bash

git fetch target

获取远程仓库提交的 hash 值

bash

git log target/master

使用 cherry-pick 选取提交

bash

git cherry-pick <commitHash>

参考链接

git cherry-pick 教程

tag - 标签

标签是版本库快照。通过标签，无需使用 commit_id 来获取固定版本代码

基本操作

命令	作用
`git tag`	查看所有标签
`git show-ref --tags`	查看所有远程标签
`git tag <tag-name>`	创建标签
`git tag -a <tag-name> -m <comment>`	为标签增加说明
`git show <tag-name>`	查看标签内容
`git tag -d <tag-name>`	删除标签
`git push origin :refs/tags/<tag-name>`	删除远程标签

批量处理

bash

# 删除所有标签（本地）
git tag -l | xargs git tag -d ）

# 批量删除包含beta的标签（本地）
git tag | grep 'beta' | xargs git tag -d

# 批量删除包含beta的标签（远程）
git show-ref --tags | grep 'beta' | awk '{print $2}' | xargs git push origin --delete

补充

bash

$ git show-ref --tags | grep 'beta'
9fa2ef1cc8483b4b1....2fceda9a3ea4e0af8f2 refs/tags/v0.0.29-beta.0
cd92619c6207eba22....5de8fef8e2163713f08 refs/tags/v0.0.29-beta.1

awk：一种处理文本文件的语言

bash

$ git show-ref --tags | grep 'beta' | awk '{print $2}'

refs/tags/v0.0.29-beta.0
refs/tags/v0.0.29-beta.1

${number}：第 number 个，以空格分隔

$1 - 9fa2ef1cc8483b4b1....2fceda9a3ea4e0af8f2

$2 - refs/tags/v0.0.29-beta.0

推送和拉取

命令	作用
`git push origin --tags`	推送所有标签
`git push origin <tag-name>`	推送指定标签
`git clone --branch <branch-name> <remote-url>`	拉取指定分支

--branch 可简写为 -b

other - 杂项命令

rm - 清除缓存区

git rm 等效 rm + git add

git rm	git rm --cached	git restore --staged
从版本库移除，本地也移除	从版本库移除，本地存在（也可用于移除暂存区）	移出缓存区

shell

# 从版本库移除，本地也移除
git rm <fileName>
# 删除文件夹
git rm -r <fileName>

shell

# 从版本库移除，本地存在（也可用于移除暂存区）
git rm --cached <fileName>

restore

shell

# 移出缓存区 - 适用于（未commit）
git restore --staged <file>
# 还原文件
git restore <file>

删除都是针对当前分支

mv - 修改文件名

git mv 等效 mv + git add

shell

git mv index.js Index.js

git 文件名大小写不敏感，如果直接修改文件名，则无法追踪变化。

另一种方法：手动改为 index.js => demo.js，然后 commit，再 demo.js => Index.js

archive - 打包操作

bash

# 生成zip
git archive master --prefix='confict/' --format=zip > master.zip

git archive master --format=tar.gz --output=./master.zip

bash

--format <fmt>        archive format
--prefix <prefix>     prepend prefix to each pathname in the archive
-o, --output <file>   write the archive to this file

diff - 差异

查看工作区、暂存区、本地版本库之间的文件差异

blame - 历史信息

查看文件每行代码块的历史信息

shell

git blame -L 1,10 demo.html

submodule - 子模块

通过 Git 子模块可以跟踪外部版本库，它允许在某一版本库中再存储另一版本库，并且能够保持 2 个版本库完全独立

shell

# 添加子模块
git submodule add https://github.com/gafish/demo.git demo
# 更新子模块
git submodule update demo

gc - 垃圾回收

运行 Git 的垃圾回收功能，清理冗余的历史快照

shell

git gc

archive - 打包

将加了 tag 的某个版本打包提取

--format ：打包格式

shell

git archive -v --format=zip v0.1 > v0.1.zip

worktree - 工作树

bash

# 工作树详情
git worktree list
git worktree list --porcelain # 更完整

# 创建工作树
git worktree add ../工作树目录 分支(commits ID)

# 移除工作树
git worktree remove <worktreePath>
git worktree remove -f <worktreePath> # 强制清理

# Prune working tree information in $GIT_DIR/worktrees.
git prune

Git ​

基础 ​

status - 状态 ​

branch - 分支命令 ​

log - 版本历史 ​

log ​

reflog ​

commit - 提交 ​

push - 推送 ​

stash - 临时存储区 ​

config - 配置 ​

remote - 远端操作 ​

fetch - 拉取 ​

merge - 合并分支 ​

rebase - 变基 ​

分支合并 ​

合并 commits ​

参考链接 ​

pull - 拉取 ​

checkout - 切换分支 | 还原 ​

reset - 重设 ​

revert - 撤销 ​

cherry-pick - 筛选 ​

基本用法 ​

转移多个提交 ​

配置项 ​

代码冲突 ​

转移到另一个代码库 ​

参考链接 ​

tag - 标签 ​

基本操作 ​

推送和拉取 ​

other - 杂项命令 ​

rm - 清除缓存区 ​

restore ​

mv - 修改文件名 ​

archive - 打包操作 ​

diff - 差异 ​

blame - 历史信息 ​

submodule - 子模块 ​

gc - 垃圾回收 ​

archive - 打包 ​

worktree - 工作树 ​

Git

基础

status - 状态

branch - 分支命令

log - 版本历史

log

reflog

commit - 提交

push - 推送

stash - 临时存储区

config - 配置

remote - 远端操作

fetch - 拉取

merge - 合并分支

rebase - 变基

分支合并

合并 commits

参考链接

pull - 拉取

checkout - 切换分支 | 还原

reset - 重设

revert - 撤销

cherry-pick - 筛选

基本用法

转移多个提交

配置项

代码冲突

转移到另一个代码库

参考链接

tag - 标签

基本操作

推送和拉取

other - 杂项命令

rm - 清除缓存区

restore

mv - 修改文件名

archive - 打包操作

diff - 差异

blame - 历史信息

submodule - 子模块

gc - 垃圾回收

archive - 打包

worktree - 工作树