前端规范前端规范
首页
  • HTML 编码规范
  • CSS 编码规范
  • JavaScript 编码规范
  • Typescript 编码规范
  • Node 编码规范
  • Git 规范
  • 文档规范
  • CHANGELOG 规范
  • eslint-config-fd
  • web-fe-stylelint
  • web-fe-commitlint
  • web-fe-markdownlint
  • eslint-plugin-fe
  • web-fe-lint
首页
  • HTML 编码规范
  • CSS 编码规范
  • JavaScript 编码规范
  • Typescript 编码规范
  • Node 编码规范
  • Git 规范
  • 文档规范
  • CHANGELOG 规范
  • eslint-config-fd
  • web-fe-stylelint
  • web-fe-commitlint
  • web-fe-markdownlint
  • eslint-plugin-fe
  • web-fe-lint

前端开发规范

前端编码规范工程化

立即开始Git Hub

标准的行业规范

依托于行业标准及最佳实践,帮助您提升项目健壮性

全面的前端生态

支持前端全部生态,无需关注环境,支持直接使用

完善的规范配件

支持对全部前端配置实现一键接入、一键扫描、一键修复、一键升级

⭐ 设计目的

随着前端技术的发展,前端项目正在变得越来越复杂。JavaScript 作为一门弱类型解释性编程语言,其灵活多变的语法极大的提高了前端开发效率,但同时也存在一系列问题。在大型项目开发过程中,代码维护所占的时间比重往往大于新功能的开发。因此编写符合团队编码规范的代码是至关重要的。 一致性的代码规范可以增强团队开发协作效率、提高代码质量、减轻项目维护的负担。但是每个人的代码编写喜好不同,代码风格也有所差异,若要一个团队内所有的成员都能发挥最大程度的价值,一个具有普适性的标准是必不可少的。

目前行业现状,很多团队的基础建设都只是简单地知晓其中一部分规范工具的使用,但却没有一套完整的工程化产出来助力研发同学实现规范落地。因此,如果我们能够产出一套完整化的前端编码规范工具,将有利于提高项目的编码质量,减少项目维护成本,这也是设计此规范的初衷!

💡 为什要前端工程化

通过本套规范,您将了解到:

  1. 现有前端前沿的研发流程下,我们可以通过哪些工具提升项目的编码规范,并提供配套工具的最佳实践,包括但不限于eslint、stylelint、commitlint、markdownlint、husky等;
  2. 如何对新项目添加规范:支持一键接入新增项目,通过结合gitpre-commit钩子,对提交文件进行编码规范的扫描;同时通过husky的commit-msg钩子,对本次代码提交message的格式进行扫描。

🛋️ 配套工具

我们引入了多个业界流行的 Linter 作为规范文档的配套工具,并根据规范内容定制了对应的规则包,它们包括:

规范Lint 工具NPM 包
JavaScript 编码规范
TypeScript 编码规范
Node 编码规范
ESLinteslint-config-fd
CSS 编码规范stylelintweb-fe-stylelint
Git 规范commitlintweb-fe-commitlint
文档规范markdownlintweb-fe-markdownlint
Eslint 插件ESlint Plugineslint-plugin-fe

web-fe-lint 收敛屏蔽了上述依赖和配置细节,提供简单的 CLI 和 Node.js API,让项目能够一键接入、一键扫描、一键修复、一键升级,并为项目配置 git commit 卡口,降低项目接入规范的成本。

您可以使用web-fe-lint 方便地为项目接入全部规范。

其他

测试markdown config

全局安装markdownlint-cli

npm i -g markdownlint-cli
pnpm run lint

生成CHANGELOG

参考conventional-changelog-cli,全局安装conventional-changelog-cli:

npm install -g conventional-changelog-cli
pnpm run changelog

📧 联系

  • zhengyou007@163.com