前言
公司一个老项目,没有做代码提交前的校验,我拿到后,想着老项目嘛也没时间帮它弄这些,反正就是改一点点小东西;尽量跟着它的代码风格写,写完提windows11有必要升级吗交就行;
直到某一天,又有一个人加入了进来。好家伙,直接干出事了。
很多个文件一起提交的,然后 commit-msg 不规范,代码缩进也不规范,换行符也不一致,里面还有很多没用的代码,可读性极差;
当你某一天 fetch 代码时,发现很多文件是这样的 你是不是很崩溃?
但问题终归是得去解决的;治理污水的最好方法就是从能污水产生的地方开前端和后端始前端和后端整治。我来帮它加jsonyau上吧。
下面我将带大家一起,先通过husky
+eslint
完成一个最简单的代码规范校验,然后逐步优化,最后通过husky
+eslint
+lint-stage
+commitlint
+prettier
实现一个强有力的限制。最前端和后端哪个工资高后再配合commilinux命令tizen
,通过commitlint-config-cz
+cz-cuWindowsstomizjson文件是干什么的able
实现自定义的提交模板和限制规则来实现团队最终的项目提交限制规约
。
eslint+pretjson怎么读tier
这里我为windows10该项目适配了一套 eslit 规则json文件是干什么的,按照这套规则提交的代码不会有冲突。
eslint 和 prettier 大家平时项目应该都用到过,应该都很熟悉了,这里将不占用篇幅。(想看的可以私聊我,我可以单独出一篇 eslint 和linux系统 prettier 主题的文章)
在这篇文章中,主要讲解如何在团队协同工作时,在 git 提交代码更改前,对不规范的代码和提交信息进行校验,修复,并限制不规范的提交。
husky
首先要介绍的是husky
,搞工程化,我们肯定都少不前端了 husky
,它能很方便的帮我们阻挡小可爱们的进攻,不,是为我们前端和后端的项目添加git hooks
具体方法
首先我们将 husky
安装到开发依赖中
npm i husky -D
# or
yarn add husky -D
注意
目前我所安装的版本是
husky@7.0.4
,由于husky@6.0.0
后做了breaking change
,所以在6.0.0
版本之前的那种设置钩子的方法前端已经不适用了,这里我们只介绍最新的方式json数据。
安装完后,我们需要在当前项目中创建一个.husky
目录并指定该目录为 git hooks
所在的目录。
使用以下命令快速创建
#--no-install 参数表示强制npx使用项目中node_modules目录下的husky依赖包
npx --no-install husky install
为了让其他人在此项目中安装依赖后也能自动创建.husky
目录并指定该目录为 git hooks
所在的目录,我们需要在前端工程师 package.json
里面添加一条脚本"prepare": "husky install"
使用以下命令快速添加
npm set-script prepare "husky install"
prepare
脚本会在npm i
或者其他yarn or yarn add
之后自动执行。也就是说当我们安装依赖后会自动执行husky install
命令,从而自动创建.husky
目录并指定该目录为git hooks
所在的目录。
使用以下命令快速windows10激活密钥创建
npx --no-instal husky add .husky/pre-commit "npm run [你要执行的命令]"
完windows11有必要升级吗成后可以看到前端面试题.husky
目录下新增了一个pre-commit
文件,其中的内容为
这里我用的是npm run lint
,这样我们就前端和后端的区别可以配合 Eslinjson文件是干什么的t 的代码校验,来限制不规范代码的提交了
可以看到,不符合 Eslint 校验规则的代码是没法提交的;
当然,这里的报错问linux是什么操作系统题只是由于缩进不规范引起的,类似这种的问题还有引号,句尾分号,换行符等等…都可以通过 eslint
的参数 --fix
来自动修复,这样就可以linux常用命令在提交前,先将能实现自动修复的简单代码风格问题后 commit。复杂的情况还是要自己去手动处理的。
说到换行符,这里我们需要了解的是:在windows11有必要升级吗 Windows 上默认的是回车换行(Carriage Return Line Feed, CRLF),然而,在 Linux/MacOS 上则是换行(Line Feed, LF)。
我们可以试一下将原先换行符为crlf
的文件格windows11有必要升级吗式化为换行符为lf
后,执行git add .
的情况。
可以看到最终 LF 换行符还是被 CRLF 转化linux删除文件命令了;
如果你们不会跨平台协作(都windows无法连接到打印机在 Mac/Linux,或者都在 Windows 上协同),只需要在当前项目中通过git config core.autocrlf falinux命令lse
来阻止这种情json文件是干什么的况的发生。
为了保险起见,你需要新建一个.gitattributes
文件(主要用于定义每种文件的属性,以方便 git 帮我们统一管windows许可证即将过期怎么办理。),设置 eol(Windowsend of line)为指定的换行符(linux系统安装lf/crlf),这里我把所有文件*.*
的换行符都设置为了 LF,并且将一些非文本文件进行了标记(排除它们),你也可以对每一种文件类型分别设置对应的属性 => *.js eol=lf
,*.ts eol=lf
…
*.* eol=lf
*.jpg -text
*.png -text
...
# 或者
*.js eol=lf
*.ts eol=lf
*.json eol=lf
...
文件内容如下
这样,我们不管在什么平台上开发,文件换行符都统一为 LF。
可以看到使用.gitLinuxattributes
配置文件后执行git add
,所windows10有不是指定换JSON行符的文件都会被自动更换为你指定的换行符,例如我这里指定了lf
,那么 git add .
后,不是以 lf
换行的文件都会被转换为 lf
,并在终端输出warning: CRLF will be replaced by LF in xxxx/filename
,如图
.gitattributes
有很多用处,具体可以查看 gitattributes。
到这里,一个最简单的代码风格限前端是什么工作制方法就json数据已经实现了。
既然做了,就肯定要做一套完整前端开发的,且好用的。下面我们来继续完善其他功能 ~
lint-staged
什么是lint-staged
?顾名思义,借JSON助这个工具只是用来检查 git 暂存区文件的,就是在你git add file1,2,3...
后的暂存区文件中运行 linjsonpt
的一个工具。
每次提交一两个文件,却都要 lint
所有文件话,是很没有必要的,我们只json格式对需要提交的代码进行 lint
,这样可以减少很多没必要的时间开销。(如果你每次修改一个文件,都要去 lint
所有文件,这个工linux系统安装具对你来说就没有什么意义了,husky
就管够 )
使用方法
我们将.husky/pre-commit
中linux删除文件命令之前写代码改为
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"
- npm run lint
+ npx --no-install lint-staged
然后在 package.json 中添加jsonyau以下代码,lint-staged
对象中采用键值对的方式进行配置,键名是你想处理的单个文件或一个文件类型,多个类型可以写在{linux删除文件命令}
中,用逗号分隔;键值是一个数组,数组中为 lint 时需要执行的命令组。
{
"lint-staged": {
"*.{ts,js,vue}": ["eslint", "echo '没问题!'"]
}
}
添加玩上述代码后,我们通过测试,将两个文件的缩进改为不符合规范的情况,然后将其中一个文件暂linux系统存后,我们运行git commit
后发现终端的报错中,只有一个文件的 lint
报错信息,另一个文件的报错并没有出现。
当所有暂存区代码都符合规范时 ,才会通过校验执行提交。
✔ Preparing lint-staged...
✔ Hiding unstaged changes to partially staged files...
✔ Running tasks for staged files...
✔ Restoring unstaged changes to partially staged files...
✔ Cleaning up temporary files...
c前端和后端ommitizen
Commitizen 是一个撰写符合上面 Commijson文件怎么打开t Message 标准的一款工具。通过json数据它可以实Linux现交互式撰写规范的 Commit Message。json数据
如果只在本仓库使用
npm install commitizen -D
如果你想全局windows10激活密钥都用 commitizen 来帮你做 commit
npm install commitizen -g
安装完成后,一般我们都采用符合 Angular 的 Commit message 格式的提交规范(当前端电视剧然也可以自定义,后面会讲到~),运行以下命令生成符合 Angular 提交规范格式的 Commit message。
如果你项目用的是 npm
# 如果你项目用的是npm
npx --no-install commitizen init cz-conventional-changelog --save-dev --save-exact
如果你项目用的是 yarn
# 如果你项目用的是yarn
npx --no-install commitizen init cz-conventional-changelog --save-dev --save-exact
运windows无法连接到打印机行了上述命令后,它将为你项目安装 cz-conventional-changelog 适配器模块,把 config.commitizen 的密钥添加到文件的根windows7旗舰版目录添加到 pajson数据ckage.json
中
可以在package.json
中看到,自动的新增了以下内容
{
...
"config": {
"commitizen": {
"path": "./node_modules/cz-conventional-changelog"
}
}
...
}
完成后,通过命令yarjsonpn cz
,你如果是全局前端开发安装的 commitizen
,那你linux直接 git cz
,都可以通过以下交互式的撰写 commit messag 然后提交
限制 comwindows键是哪个mitlint
由于 commitizen 并不是强制使用的,仍然可以通过git commit
来提交,所以我们必须在不管是通过cz
还是git commit
提交前,都要对 commit messag 进行一次校验,不符合规范的情况下是不允许进行 commit 的
首先我们需要安装commitlint
,commitlin前端和后端哪个工资高twindows无法连接到打印机/config-conventional
yarn add @commitlint/cli @commitlint/config-conventional -D
使用以下命令快速创建 git hooks 的 commit-msg 钩子 这样每次 commitjsonyau 的时候都会由 commitlint 对 commit message 进行一次检验
npx --no-instal husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'
然后我们创建一个 commwindows是什么意思itlint 配置文件到项windows10目根目录
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
以上将会linux必学的60个命令在项目目录中生成 commitlint.config.js
,代码如下,他将继承@commitlint/confilinux重启命令g-conventjsonpional
中的 Commit message 规范。(”feat”, “fix”, “pjson格式erf”, “refactor”…)前端学什么
module.exports = {
extends: ["@commitlint/config-conventional"],
};
然后我们在终端进行测试
echo 'feat: bar' | npx --no-install commitlint
如果你执行windows怎么激活上面这个行命令后出现了以上这种报错。
将文件更改问 UTF-8 的格式即可解决;这个问题目前已经在 Issues中,有不少人遇到linux必学的60个命令了(我也是 )。
最简单的方法就是,把文件用记事本打开,选择另存为,然后在弹窗前端学什么的右下角更改字符编码为 UTF-8 (eslint是什么Windows 用户运行echo "xxx" > xx.js
时,文件编码可能为 UTF-16 LE),更改好后,把原来的commitlint.config.js
文件替换掉即可。
解决以上问题后,我们再测试一下,可以看到,不符合规范的 commjson怎么读it-linux命令msg 是会导致报错的,也就windows怎么激活 commit 不了了,说明我们的 commitlint 已经生效了~
到此,commit-msg 的校验也已经完成 ✔
如果,你想自定义 commitlint 的交互文本(不用 feat,fix…,很多人都喜欢在 cojson怎么读mmit message 前面linux必学的60个命令加一个 emoji 表情符号),当然也可以。
我们需要安装 czjson数据-customizable
来实现自定jsonyau义 commit message 规则,以及安linux常用命令装对应的commitlint-config-cz
来配套校验(直接从自定义的文件里读取规则)
运行以下命令
yarn add commitlint-config-cz cz-customizable -D
在项目根目录,创建一个.cz-config.js
文件,并复制cz-config-EXAMPLE.js 中的内容到其中。然后改成你自己想要的规则即可。
当然,你也可以用我写好的windows键是哪个:
module.exports = {
types: [
{ value: "feat", name: "feat: 一个新的特性" },
{ value: "fix", name: "fix: 修复一个Bug" },
{ value: "docs", name: "docs: 变更的只有文档" },
{ value: "style", name: "style: 代码风格,格式修复" },
{ value: "refactor", name: "refactor: 代码重构,注意和feat、fix区分开" },
{ value: "perf", name: "perf: 码优化,改善性能" },
{ value: "test", name: "test: 测试" },
{ alue: "chore", name: "chore: 变更构建流程或辅助工具" },
{ value: "revert", name: "revert: 代码回退" },
{ value: "init", name: "init: 项目初始化" },
{ value: "build", name: "build: 变更项目构建或外部依赖" },
{ value: "WIP", name: "WIP: 进行中的工作" },
],
scopes: [],
allowTicketNumber: false,
isTicketNumberRequired: false,
ticketNumberPrefix: "TICKET-",
ticketNumberRegExp: "\\d{1,5}",
// it needs to match the value for field type. Eg.: 'fix'
/*
scopeOverrides: {
fix: [
{name: 'merge'},
{name: 'style'},
{name: 'e2eTest'},
{name: 'unitTest'}
]
},
*/
// override the messages, defaults are as follows
messages: {
type: "选择一种你的提交类型:",
scope: "选择一个scope (可选):",
// used if allowCustomScopes is true
customScope: "Denote the SCOPE of this change:",
subject: "简短说明(最多40个字):",
body: '长说明,使用"|"换行(可选):\n',
breaking: "非兼容性说明 (可选):\n",
footer: "关联关闭的issue,例如:#12, #34(可选):\n",
confirmCommit: "确定提交?",
},
allowCustomScopes: true,
allowBreakingChanges: ["feat", "fix"],
// skip any questions you want
skipQuestions: ["scope", "body", "breaking"],
// limit subject length
subjectLimit: 100,
// breaklineChar: '|', // It is supported for fields body and footer.
// footerPrefix : 'ISSUES CLOSED:'
// askForBreakingChangeFirst : true, // default is false
};
创建完.cz-config.js
文件后,我们需要回到 packawindows10激活密钥ge.json 文件中,将 config.commitilinux必学的60个命令zen.patheslint是什么 更改为"node_modules/cz-jsoncustolinux删除文件命令mizable"
,如果你的.cz-config.js
文件在项目根目录下,那么可以不配置下面这条前端和后端的区别,linuxcommitlint-confi前端电视剧g-cz 会自动在项目根目录下寻找: .cz-config.js
或 .config/cz-linux系统安装config.js
...
{
"config": {
"commitizen": {
"path": "node_modules/cz-customizable"
},
// 如果你的.cz-config.js文件在项目根目录下,那么可以不配置下面这条,commitlint-config-cz会自动在项目根目录下寻找: .cz-config.js 或 .config/cz-config.js
"cz-customizable": {
"config": "你的文件路径/xxxconfig.js"
}
}
}
...
关于commitlint-config-cz
更高级的用法可以查看 commitlint-c前端电视剧onfig-cz
最后我们将之前创建过的commitlint.config.js
中的代码进行更改
module.exports = {
- extends: ["@commitlint/config-conventional"],
+ extends: ["cz"],
};
或者你也可以在commitlint.config.js
中手动添加自定义的规则 ,他将覆盖 extends 中的规则
module.exports = {
extends: ["@commitlint/config-conventional","cz"],
rules: {
"type-enum": [
2,
"always",
[
"init",
"build",
"ci",
"chore",
"docs",
"feat",
"fix",
"perf",
"refactor",
"revert",
"style",
"test",
],
],
},
};
到这里,自定义的 commit message 的校验也 ok 了 ✅
最后
提醒:项目的代码风格和规则要和团队一起制定哦 ~
至此,在团队协同的项目中,不符合规范的提交就被扼杀在摇篮里面了。我们大家不管是从书写代码还是提交代码最好都要规范哦~ 不给自己惹麻烦windows键是哪个的同时,也不会给他人或公司带来麻烦。这就是本篇的全部内容啦~如果对你有帮助,记得点赞鼓励 ~
我是荣顶,一个面向快乐编程的前端开发
如果前端开发你也非常热爱前端相关技术!点击 → 前端超人 技术交流群