Git

基础概念

• workspace： 本地工作区（即你编辑器的代码）
• Index： Git 追踪树,暂存区；
• Repository： 本地仓库；
• Remote: 远程主仓库；

提交流程

工作区 -> git status 查看状态 -> git add . 将所有修改加入暂存区-> git commit -m "提交描述" 将代码提交到 本地仓库 -> git push 将本地仓库代码更新到 远程仓库

工作区

提交文件到暂存区

# 提交单个文件
git add <文件名>

# 提交所有文件
git add .

丢弃工作区的修改

# 丢弃单个文件
git checkout -- <文件名>

暂存区

将代码提交到本地仓库

git commit -m “新提交消息”
git commit --amend --no-edit

提交完后更改 commit 信息

git commit --amend -m “新提交消息”

部分漏提交的重新提交

git add <文件名>
git commit --amend --no-edit

--no-edit 表示提交消息不会更改，在 git 上仅为一次提交

把暂存区的修改撤销掉（unstage），重新放回工作区。

git reset HEAD <文件名>

本地仓库

提交本地仓库到远程仓库

git push

# 强制提交 谨慎使用
git push -f -u origin master

Config

在服务器中安装完 git 后，即可对它进行基础配置。全局配置邮箱及用户名，此时就可以愉快地在服务器中使用 git 管理代码了

git config --global user.name <your name>
git config --global user.email <your_email@example.com>
git config --global push.default simple
git config --global core.quotepath false
git config --global core.editor /usr/bin/vim
git config --global credential.helper store
git config --global credential.helper wincred
git config --global core.ignorecase false
# 设置大小写敏感，保持 Mac/Win/Linux一致性；在目录名大小写修改时，git可正常提交；
git config --global core.ignorecase false

分支管理

git diff --quiet HEAD

它可以用来帮助确定工作树中是否有任何变化，通过比较您的工作树和 HEAD 版本。——quiet表示关闭输出，并根据树是否被修改(以 1 退出)或未被修改(以 0 退出)来更改退出代码。

查看分支

# 查看本地分支
git branch

# 查看远程分支
git branch -r

# 查看所有分支
git branch -a

分支清理

git remote prune origin

如果需要删除所有已经合并到master下的本地分支，可以使用如下命令：

git fetch -p ; git branch -r | awk '{print $1}' | egrep -v -f /dev/fd/0 <(git branch -vv | grep origin) | awk '{print $1}' | xargs git branch -d

合并（Merge）

当我们在不同分支开发完代码后，会选择将分支进行合并（merge）。平时常用的 git merge 操作，又可分为这两种类型：fast-forwar 和no-fast-forward。

一般情况下，Git 会默认使用 fast-forward 这种类型来处理分支合并，当我们成功合并后，不会产生任何提交记录，且当旧分支被移除后，其分支信息也会被一并删除。

而当我们使用 no-fast-forward 模式，即在合并分支命令加入 --no-ff 后缀的方式运行时，便会生成一个新的提交记录

基变 (Rebasing)

版本管理

tag

删除所有包含 testing 的 tag

git tag -d $(git tag | grep "testing")
git push -d <remote> $(git tag | grep "testing")

删除所有不包含 fruit 的 tag

git tag -d $(git tag | grep -v "fruit")
git push -d <remote> $(git tag | grep -v "fruit")

删除所有 Tag

git tag -d $(git tag)
git push -d <remote> $(git tag)

快捷回退版本

修改版本库，保留暂存区，保留工作区

将版本库软回退 1 个版本，软回退表示将本地版本库的头指针全部重置到指定版本，且将这次提交之后的所有变更都移动到暂存区。

git reset --soft HEAD~1

修改版本库，修改暂存区，修改工作区

将版本库回退 1 个版本，不仅仅是将本地版本库的头指针全部重置到指定版本，也会重置暂存区，并且会将工作区代码也回退到这个版本

# 回退到上一个版本
git reset --hard HEAD^

# 回退到上上一个版本
git reset --hard HEAD^^

回滚

先查看版本库的状态

git log

此时会查看到如以下的信息

commit e475afc93c209a690c39c13a46716e8fa000c366 (HEAD -> master)
Author: Michael Liao <askxuefeng@gmail.com>
Date:   Fri May 18 21:03:36 2018 +0800

    add distributed

commit eaadf4e385e865d25c48e7ca9c8395c3f7dfaef0
Author: Michael Liao <askxuefeng@gmail.com>
Date:   Fri May 18 20:59:18 2018 +0800

    wrote a readme file

回退到指定的版本

git reset --hard eaadf4e
git push -f

远程仓库回滚

git push -f

版本号没必要写全，前几位就可以了，Git 会自动去找。当然也不能只写前一两位，因为 Git 可能会找到多个版本号，就无法确定是哪一个了。

git revert 和 git reset 的区别

• git revert 是用一次新的 commit 来回滚之前的 commit，git reset 是直接删除指定的 commit。
• 在回滚这一操作上看，效果差不多。但是在日后继续 merge 以前的老版本时有区别。因为 git revert 是用一次逆向的 commit“中和”之前的提交，因此日后合并老的 branch 时，导致这部分改变不会再次出现，但是 git reset 是之间把某些 commit 在某个 branch 上删除，因而和老的 branch 再次 merge 时，这些被回滚的 commit 应该还会被引入。
• git reset 是把 HEAD 向后移动了一下，而 git revert 是 HEAD 继续前进，只是新的 commit 的内容和要 revert 的内容正好相反，能够抵消要被 revert 的内容。

提交记录

git --no-pager log HEAD --pretty="----%n%s|%h|%an|%ae%n%b" --name-status
git --no-pager log v0.0.29...master --pretty="----%n%s|%h|%an|%ae%n%b" --name-status

export async function getGitDiff(
  from: string | undefined,
  to = 'HEAD'
): Promise<RawGitCommit[]> {
  // https://git-scm.com/docs/pretty-formats
  const r = await execCommand('git', [
    '--no-pager',
    'log',
    `${from ? `${from}...` : ''}${to}`,
    '--pretty="----%n%s|%h|%an|%ae%n%b"',
    '--name-status',
  ])
  return r
    .split('----\n')
    .splice(1)
    .map((line) => {
      const [firstLine, ..._body] = line.split('\n')
      const [message, shortHash, authorName, authorEmail]
        = firstLine.split('|')
      const r: RawGitCommit = {
        message,
        shortHash,
        author: { name: authorName, email: authorEmail },
        body: _body.join('\n'),
      }
      return r
    })
}

degit

• degit

提交信息效验

语意 git 提交 git-cz，确保 git 的提交信息规范化，利于 CHANGELOG 生成

• feat：新功能（feature）
• fix：修补 bug
• doc：文档（documentation）
• style： 格式（不影响代码运行的变动）
• refactor：重构（即不是新增功能，也不是修改 bug 的代码变动）
• test：增加测试
• chore：构建过程或辅助工具的变动
• perf：性能优化，提高性能的代码更改

添加信息效验 hook， 在 git commit 时执行脚本 verify-commit.js 验证 commit 消息。如果不符合脚本中定义的格式，将会报错。

在 git commit 时执行检验提交的说明是否符合规范，不符合则不可以提交

安装 @commitlint/config-conventional、@commitlint/cli

pnpm add @commitlint/config-conventional @commitlint/cli -D

创建 commitlint.config.js 文件，配置效验方式

echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js

将代码提交到远程仓库前对提交的代码进行检查，如果符合规范，则可进行提交，如果不符合规范则不允许提交到远程仓库， 这样才能确保远程仓库的代码都是风格一致的代码

提交信息规范

良好的代码提交记录能很快的看出每次你提交的代码都做了哪些的修改，主要可以分为 header body footer 三部分

<!-- header -->
feat: 添加了分享功能

<!-- body -->
给每篇博文添加了分享功能

- 添加分享到微博功能
- 添加分享到微信功能
- 添加分享到朋友圈功能

<!-- footer -->
Issue #1, #2
Close #1

Header 修改类型

类型	描述
feat	新功能、新特性
fix	修改 bug
perf	更改代码，以提高性能
refactor	代码重构（重构，在不影响代码内部行为、功能下的代码修改）
docs	文档修改
style	代码格式修改, 注意不是 css 修改（例如分号修改）
test	测试用例新增、修改
build	影响项目构建或依赖项修改
revert	恢复上一次提交
ci	持续集成相关文件修改
chore	其他修改（不在上述类型中的修改）
release	发布新版本
workflow	工作流相关文件修改

Body 部分是对本次 commit 的详细描述，可以分成多行。

Footer 部分只用于两种情况：

• 关联 Issue
• 关闭 Issue

cz-cli 命令行工具帮助我们生成规范的提交信息，也可使用Gitmoji添加 emoji

Reference

• Commit 规范
• Git 提交规范
• 图解 git
• commitizen
• Gitmoji