亲宝软件园·资讯

展开

js架构Git commit规范

Gaby 人气:0

Git commit 规范

在工作中避免不了多人协作,协作避免不了有一个规范的流程,让大家有效的去合作;让项目有条不紊的进行。自然使用 git 规范进行把控也是项目中必不可少的技术了。

为什么要写好 Git Commit?

  # 过滤日志信息
  git log HEAD --pretty=format:%s --grep 关键字

如何写好Git Commit

业界使用比较广泛的是Angular规范

<type>(<scope>):<subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

type | commit 类型

类型详细介绍
feat新功能、新特性
fixbugfix,修改问题
refactor代码重构
docs文档修改
style代码格式修改,注意不是css修改
test测试用例修改
chore其他修改,比如构建,依赖管理

scope | commit影响的范围 比如:route、component、utils、build.....

利用插件(commitizen)

利用commitizen,提交规范的commit。

# 1. 下载cz-conventional-changelog changelog插件 
npm install -g commitizen cz-conventional-changelog
# 2. package.json 配置

{
    "scripts": { 
    # 以后提交commit 直接执行npm run commit
       "commit": "git-cz",
    },
    # config用来设置一些项目不怎么变化的项目配置,用户用的时候可以使用如下用法:process.env.npm_package_config_commitizen
    "config": {
      "commitizen": {
        "path": "./node_modules/cz-conventional-changelog"
      }
  }
}

# 也可以使用以下配置,配置全局变量
# 命令行中输入以下命令,配置到czrc目录下,也可以用vim编辑~/.czrc添加到文件中去{ "path": "cz-conventional-changelog"}
echo '{ "path": "cz-conventional-changelog"}' > ~/.czrc

自定义文档格式,commit用中文去写(扩展)

# 1.下载
npm install -g cz-customizable
# 2. package.json 配置
...
"config": {
  "commitizen": {
    "path": "node_modules/cz-customizable"
  },
  "cz-customizable": {
    "config": "./cz.config.js"
  }
}

# 也可以使用以下配置,配置全局变量
echo '{ "path": "cz-customizable"}' > ~/.czrc
# echo添加或vim编辑添加
vim .czrc
# 添加配置 { "path": "cz-customizable"}

# 3.创建配置文件
touch ./cz.config.js

cz.config.js

module.exports = {
  //可选类型
  types: [
    { value: 'feat', name: 'feat:   新功能' },
    { value: 'fix', name: 'fix:   修复' },
    { value: 'docs', name: 'docs:   文档变更' },
    { value: 'style', name: 'style:   代码格式(不影响代码运行的变动)' },
    {
      value: 'refactor',
      name: 'refactor:重构(既不是增加feature),也不是修复bug'
    },
    { value: 'perf', name: 'perf:   性能优化' },
    { value: 'test', name: 'test:   增加测试' },
    { value: 'chore', name: 'chore:   构建过程或辅助功能的变动' },
    { value: 'revert', name: 'revert:   回退' },
    { value: 'build', name: 'build:   打包' },
    { value: 'revert', name: 'revert:   回退' }
  ],
  //消息步骤
  messages: {
    type: '请选择提交类型',
    customScope: '请输入修改范围(可选)',
    subject: '请简要描述提交(必填)',
    body: '请输入详细描述(可选)',
    footer: '请输入要关闭的issue(可选)',
    confirmCommit: '确认以上信息提交?(y/n)'
  },
  //跳过问题
  skipQuestion: ['body', 'footer'],
  //subject文字长度默认是
  subjectLimit: 72
}

gitmoji(趣味图标-扩展)

npm i -g gitmoji-cli
gitmoji -c # git commit 提交

Git hooks

Git 钩子(hooks)是在Git仓库中特定事件(certain points)触发后被调用的脚本

可以用git init初始化git文件,在.git/hooks下有各种钩子模版,可以用例如less prepare-commit-msg.sample查看文件,里面是一段执行脚本。

客户端 Hooks

类型详细介绍
prepare-commit-msgcommit message编辑器呼起前 default commit message创建后触发,常用于生成默认的标准化的提交说明
commit-msg开发者编写完并确认commit message后触发,常用于校验提交说明是否标准
post-commit整个git commit完成后触发,常用于邮件通知、提醒
applypatch-msggit am提取补丁并 应用于当前分支后,准备提交触发,常用于执行测试用例或检查缓冲区代码
pre-applypatchgit am提交后触发,常用于通知、补丁、邮件推送回复(此钩子不能停止git am过程)
pre-rebase执行git rebase命令时触发
post-rewrite执行会替换commit的命令时触发,比如git rebase 或 git cimmit-amend
post-checkout执行git checkout命令成功后触发,可用于生成特定文档,处理大二进制文件等
post-merge成功完成一次merge行为后触发
pre-auto-gc执行垃圾回收前触发

服务端 Hooks

类型详细介绍
pre-receive当服务端收到一个push操作请求时触发,可用于检测push的内容
update与pre-receive相似,但当一次push想更新多个分支时,pre-receive只执行一次,而此钩子会为没一分支都执行一次
post-receive当整个push操作完成时触发,常用于服务侧同步、通知

项目使用

Git Husky

用node实现的的快速安装git hooks的工具

// npm install husky --save-dev
// package.json
{
  "husky" : {
    "hooks": {
       "pre-commit": "npm test",
        // ......
    }
  }
}

命令行 less .git/hooks/pre-commit 查看pre-commit文件,可以看见"(dirname"(dirname "(dirname"0")/husky.sh",然后可以查看less .git/hooks/husky.sh

link-staged

只会检测暂存区的文件,不会对所有的文件进行检测,也就是说我修改一个文件,只会检测当前这个文件

 # 安装代码检测工具
 npm install prettier eslint -D
 # 安装lint-staged
 npx mrm lint-staged
{
"gitHooks": {
    "pre-commit": "lint-staged"
  },
{
  "lint-staged": {
    "*.js": "eslint --cache --fix",
    "*.{js,css,md}": "prettier --write"
  }
}

加载全部内容

相关教程
猜你喜欢
用户评论