type
status
date
slug
summary
tags
category
icon
password
😀
代码良好的规范性,有益于项目版本迭代,有助于代码审查
 

📝 主旨内容

使用的工具

  1. husky: Git hooks 工具
对git执行的一些命令,通过对应的钩子函数触发,执行自定义的脚本程序
  1. eslint:插件化的JS代码检测工具,说实话我不想用,这里就没写了。
  1. prettier: 代码格式化工具,安装插件
  1. editorconfig:文件代码规范
  1. VSCode: 轻量代码编辑器

配置步骤

  1. 安装相应插件
针对你的语言选择格式化的插件,Js可以选择 Prettier,Python 选择Black……几乎每个语言都有其对应的格式化工具,接下来的步骤我将以JS为例。
  1. VSCode 配置插件
新建.vscode文件夹,创建setting.json,添加以下设置
这会告诉编辑器在保存文件时自动使用Prettier插件
  1. 配置Git钩子
  • 安装husky工具,在提交前运行格式化命令
  • 配置husky
启用git hook,执行 npx husky install,该命令会创建.husky目录和必要的配置文件
利用npm生命周期,自动执行git hook
prepare命令会在install后自动执行,这样在安装依赖的时候husky就被启用了
  • 创建hook
手动创建一个名为 pre-commit 的文件在 .husky/ 目录下
确保文件可执行:使用chmod u+x .husky/pre-commit命令将该文件设置为可执行文件
创建后的脚本内容为:
它会在commit前执行npm run fmt命令,如果报错就会终止commit
  • 配置格式化脚本:在 package.json 文件中添加一个脚本来运行格式化工具,比如 Prettier(需要先安装prettier):
  1. 设置editorconfig(解决成员们编辑器设置不同,影响代码风格)
根目录下创建.editorconfig,添加以下代码
  1. 配置prettier
安装
根目录下新建.prettierrc.yaml,加入以下内容
配置.prettierignore,配置prettier校验忽略的文件

🤗 总结归纳

总结文章的内容
其实还有很多可配置的地方,例如commitlinteslint,但是无论怎么说,自己开发起来最顺手的设置才是好设置,以上的配置对我来说完全ok了。
对于git commit的一些规范,有我们学长的另一篇博客,我将其搬到这里。
🗒️
Git工作流
文章最后,附上我做了一个demo进行commit后的命令行输出。
notion image
notion image

📎 参考文章

 
💡
相关安装或者使用上的问题,欢迎您在底部评论区留言,一起交流~
OpenAPI(Swagger)Git工作流
  • Giscus
Zachary_Yang
Zachary_Yang
一个普通的干饭人🍚
Announcement
🎉欢迎来到我的博客🎉
-- 亲爱的读者们,你们好! ---
👏在这里,我希望能够和你们一起分享我对生活的观察、对技术的理解和热爱,暂将博客分为以下几个栏目👏
🌿 心绪漫卷边:一些小随笔
🌌 智绘非遇路:AI领域
😊 浅笑编程边:前后端开发
🛠 技术汇流石下:零散技术分享

祝好,
Zachary_Yang