目录 Git commit 规范 为什么要写好 Git Commit? 如何写好Git Commit 利用插件(commitizen) Git hooks 客户端 Hooks 服务端 Hooks 项目使用 Git Husky link-staged Git commit 规范 在工作中避免不了多人协作,
目录
- Git commit 规范
- 为什么要写好 Git Commit?
- 如何写好Git Commit
- 利用插件(commitizen)
- Git hooks
- 客户端 Hooks
- 服务端 Hooks
- 项目使用
- Git Husky
- link-staged
Git commit 规范
在工作中避免不了多人协作,协作避免不了有一个规范的流程,让大家有效的去合作;让项目有条不紊的进行。自然使用 git 规范进行把控也是项目中必不可少的技术了。
为什么要写好 Git Commit?
- 提供更多的历史信息,方便快速浏览
- 可以过滤某些commit(比如文档改动),方便快速查找信息
# 过滤日志信息 git log HEAD --pretty=format:%s --grep 关键字
- 可以直接从commit生成Change log
如何写好Git Commit
业界使用比较广泛的是Angular规范
<type>(<scope>):<subject> <BLANK LINE> <body> <BLANK LINE> <footer>
- 标题行:必填,描述主要修改类型和内容
- 主要内容:描述为什么修改,做什么样的修改,以及开发的思路等等
- 页脚注释:放 Breaking Changes 或 Closed Issuses
type | commit 类型
scope | commit影响的范围 比如:route、component、utils、build.....
- subject:commit 的概述,建议符合 50/72 formatting
- body:commit 具体修改内容,可以分为多行,建议符合50/72 formatting
- footer:一些备注,通常是BREAKING CHANGE 或 修改的bug链接
利用插件(commitizen)
利用commitizen,提交规范的commit。
- commitizen 用于提示用户输入或选择,生成规范的commit
- cz-conventional-changelog 用于生成changelog
# 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
服务端 Hooks
项目使用
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" } }
以上就是js前端架构Git commit提交规范的详细内容,更多关于js架构Git commit规范的资料请关注易盾网络其它相关文章!