我的前端工程化宝典,分享给你

前言

好久没更文了,因为有很多人问我工程化相关的内容,而我之前的工作中恰好有一些工程化的经验,这里笼统地和大家分享一下(没法太具体,具体的话,每部分都需要单开文章长篇大论),所以这里旨在为大家搭建体系,有需要的话,再慢慢细出吧(比较忙,见谅啦~)

在开始前我问大家一个问题,前端工程化,是什么?

一提到前端工程化就说到webpack,难道webpack就是前端工程化吗?webpack是打包工具,啊,前端工程化就是打包啊?

好的,我知道前端工程化了,就是用webpack啦或者用vite打包,然后调一下配置项,该有的都有,打包分析treeshaking。。。

诶嘛,我还知道treeshaking呢,加分了!

哈哈哈哈,搞一个小段子~

不知道你有没有上面这样的误区,如果有,我不能说你不对

因为工程化这个东西,它并没有相对统一的规范,每个人或者说是每个公司,每个项目,都去做属于自己的工程化

这是一个摸索的过程,并没有对错之分

而在这篇文章,我就说说我对前端工程化的摸索、实践,也可以说我的前端工程化是什么样的

大家如果觉得不对,无可厚非,每个人都有自己的认知和体系,大家互相学习才是最重要的

我的工程化体系

对我来说什么是工程化

抛去代码,思考一下工程化这个词

我这里浅浅百度了一下,当然,这几点不一定全面,但是我们看看,这几个点是不是也贯穿在我们的代码开发之中呢

那么我觉得,这些点,不论是这上面谈到的,还是没谈到的,我都想把工程化的概念和用途简单化

赋能

我们开发一个项目,即是在做一个工程,我们在开发中摸索经验,积累,形成体系,给团队和接下来的项目赋能,让接下来的工作做的更好,那么我认为这就是在工程化

那么在我的开发过程中,我做过一些我认为是工程化方面的工作,来和大家分享一下,看看有些东西,大家是不是觉得耳熟

评审

需求评审,一个在做任何一个项目之前的必备步骤

可能大家做的最多的评审就是功能开发的评审,或者是项目初始开发的评审,我们会进行讨论

一般会有产品、UI、开发、测试,这是最常见的,一般来说就是产品和项目经理起草项目文档,产品和UI完善原型,然后进行功能的评审,评审难度、可行性,从而分出工时,然后在类似禅道的平台上分发任务和工时,这样就完成了一个基础的初始化体系

有了最初的体系,下面的任务才能更好地进行

规范

好的,我们已经完成了评审,要开始我们的项目开发了,假设我们这是一个新项目,技术栈已定的情况下(在我之前的工作中技术栈一般是主管定),我们要开始进行项目最开始的建设

项目规范化建设

那这个规范化,我们通常都说那几个方面呢

  • 格式规范化
  • 提交规范化
  • 命名规范化
  • 注释规范化

关于格式和提交规范,我们除了CR阶段,在日常开发中通常会怎么处理呢

相信大家看过很多文章了,所以这里简单带过一下即可

ESlint、 stylelint、prettier来处理一些语言的格式问题

配置husky的pre-commit、添加commitlint配置文件来进行提交的规范化

关于命名的规范化,可能不同的公司的处理方式是不一定的,比如动名词要求大小驼峰命名等,一般会写在公司内部的开发文档

关于开发文档这里解释一下

开发文档的形式是不固定的,可能是写在语雀飞书等文档类平台上,可能是自己通过vuepress或者vitepress自己搭建,甚至可能就是写在一个word上,这都是不固定的

开发文档也有多种,我们不去管那些产品层面的使用文档,就开发层面上来看,我目前接触的是组件文档工具文档,前者是内部组件库之类的,后者是内部封装的工具库,这二者往往需要结合文档来进行使用和记录,同时写好文档也方便别人来进行观看和更迭,当然,如果你的目的是防御式编程的话,那随意~但是在我之前的工作中,频繁的定期CR属实是不太方便防御式编程

我们回过头来,除了遵循文档,我经历过哪些命名规范的实践呢,BEM函数是一个

此方法在组件库项目中最为常用,也是开源组件库项目中比较常用的,因为单纯手动遵循BEM规范的话,属实很麻烦,所以我们借助函数来帮我们完成,大致是,引入定义块、定义元素

  • 根元素用bem()定义块
  • bem('element')定义子元素
  • 多种状态的修饰器用列表 bem([])
  • 状态为布尔类型的修饰器用对象 bem({})
  • 一个节点只用一个bem()

具体的实践和介绍可以看这篇BEM 规范及实战快速生成 - 掘金 (juejin.cn)

而关于注释规范化,其实每个公司的要求是不一样的,比如哪些注释是最后保留的,块级注释的覆盖率的等

因为块级注释可以做到更好的提示功能,而且说白了,看起来就有种规范感,领导是爱看的

同时在开发中,块级注释对于函数、对象、枚举、接口等都是很友好的

最后,关于规范,其实很多大厂是开源出自己的很多规范的,有很多小公司也都是以大厂的规范为主,大致就像这篇文章的介绍一样

推荐几款代码规范文档库,建议收藏! - 掘金 (juejin.cn)

其实还有很多规范,但是我做过的有限,所以不展开说了

工具/自研库/cli/SDK

关于工具/自研库/cli/SDK的开发,是工程化较为直观的体现了

拿上面的规范化举例,如果我们每开一个项目,都要进行如此繁琐的配置,那么是不是有够头疼,难道每新来一个同事,都要去手把手去教一下吗,显然不是的,这时候我们可以封装成一个npm库,同时如果有npm私服的话,可以放到私服上,供内部使用

当然,有钱的可能都去挂CDN了,不同的预算,不同的解决方式

同时,大家经常会看到一些文章,会觉得pnpm+monorepo似乎和前端工程化已经密不可分了,但是自己项目开发中,似乎用到的场景的并不多,难道用pnpm+monorepo只是为了并行启动项目用吗,显然并不是的

在我的工作中,pnpm+monorepo主要用于工具/自研库/cli的开发中,这三者是毫无相干的嘛?并不是的,是密不可分的,monorepo几乎取代了lerna进行多包管理,monorepo可以很好地进行拆包而这三者可以通过monorepo很好地串联在一起,形成梳理清晰的工作流

我们这里拿varlet的拆包举例,因为我觉得varlet在工程化方面做的是很好很清晰的,我也经常来借鉴借鉴大佬们的思路

我们发现,varlet通过monorepo拆包,形成了非常清晰的工作流,不论是后期的抽离,还是日常的维护,都是很清晰,舒服的

具体的拆包结构你可以根据自己的项目来定,比如我把一些utils单独拆出来,单测我也单独拆出来,达到我自己的预期需求

cli,也就是我们常说的脚手架,大部分是用来建设对应的开发模板,中间大致有下面几个阶段

  • 命令
    • commander 插件提供命令注册、参数解析、执行回调
  • 交互
    • inquirer 插件用于命令行的交互(问答)
  • 逻辑处理
    • fs-extra 插件是对 nodejs 文件 Api 的进一步封装,便于使用
    • kolorist 插件用于输出颜色信息进行友好提示

我们可以生成我们想要的模板,有对应的vue、js、ts、md等等,可以生成对应的路由,可以生成对应的单测,只要是我们想要的,我们每次都需要重复创建,手动添加的,我们都可以选择去搞一个cli来进行自动化处理

然后我们大致会达到下面的效果

后面我就不展示了,最后根据提示我们可以自动生成对应的文件模板

yike-design-dev/config/script/new-component.mjs at monorepo-dev · ecaps1038/yike-design-dev (github.com),这里放上一个示例

同时大家比较关注的还有SDK的设计,其实大家可能遇到较多的是前端监控/性能的SDK,本来我想放到后面和监控和优化的时候写的,但是这里都说到了monorepo,我觉得放在这里说也无伤大雅

SDK的设计我觉得是很值得学习的,我之前设计的思路是webpack的模式,也就是core配合plugin的方式

这里其实会引申出非常重要的一点,也就是webpack,有些朋友可能就懵了,什么意思,webpack为什么放到了这里,不是应该在打包那里吗

这里就可以纠正一下关于webpack工程化的误区

webpack打包是工程化中打包的一环,而webpack的设计思想是工程化中工具以及SDK开发的一环,而webpack配置和打包分析以及优化是工程化中优化的一环

并不是说webpack=工程化,但是并不是说webpack≠工程化,准确地说,webpack贯穿工程化,它并不是单独一两个作用那么简单
这也会体现出面试的一些问题,面试想考察webpack,并不是想单独考察你对比webpack的那几个配置,说白了,那几个配置硬记谁记得住,都是去看文档,但是webpack的设计思想和贯穿工程化的这些知识,才是更重要的

比如,在SDK开发中,我虽然用的是webpack的模式,但是我却用rollup打包,是不是蛮有意思的,哈哈哈哈哈

关于SDK的设计,我这里也有较为推荐的文章

我开源了一款轻量级前端埋点监控sdk - 掘金 (juejin.cn)

而我们之前在公司里也是采用的这种模式来进行SDK的开发

然后关于SDK的一些指标咱们下面监控和优化的时候再说

单测

单测即单元测试,其实这个大部分公司內是没有的,因为几乎测试工作都会留给专门的测试工程师来做,前端只专心做业务工作

但是这样会有一些问题,比如测试的时间和开发总是不同步,不知道大家有没有遇到过,到项目上线的最后的那两天,bug突然全被指派了出来,然后开始痛苦地加班

同时我们在进行工具等开发的时候,因为这不归属于业务,所以一般测试工程师是不参与的(当然,如果你们是参与的那更好),而且我们工具对于代码健壮性的要求是很高的,所以我们一般会进行前端方面的测试

那我们通常会进行哪些测试

  • 单元测试:测试给定函数、类和复用逻辑
  • 组件测试:检测咱们组件的挂载、渲染和交互性
  • 端到端的测试:通过真实网络请求我们应用并检测夸多页面的功能特性

因为我大部分都是用的vue,所以我们用的vitest这个框架,相信大家都有听说过,相较于之前的Jest配置简单,语法几乎相同,文档完善,是个不错的选择

同时,如果你比较关注开源项目的话,你基本会发现,现在基本上开源项目都会有单测的一环,也是PR的一个硬性要求

一般要求比较高公司或者是开源项目还会对单元测试覆盖率有一定的要求,这个就是见仁见智了

最后,单测并不是一个硬性的要求,它更多的是用于工具开发等,而在业务上较少去用,对于一个大型的业务项目来说,心智负担过大,所以前端单测现在在公司中属于不太看重的部分(但是我听说,越来越多的公司开始做前端单测了)

CR

CR,即Code Review(代码审查),我觉得是必不可少的一环,尤其是对于公司新人和实习生来说,它是对代码质量的查验,我们可以发现自己的代码哪里写的不够好,哪里可以进行改善,这对能力的提升是很有帮助的

可以帮助自己建立一个良好的代码习惯,写出更优雅的代码

不同的公司CR的标准当然是不同的,我拿我经历过的举例

我们CR间隔是比较长的,一个月一次,因为我们基本上一个月是一个业务周期,基本上一个月能完成预计的项目开发工作,然后最后打包上线前来进行质量审查

审查的点主要包括上面的代码规范的几点,然后函数的冗杂程度(就是优不优雅),如果vue、react的话会看一些hooks,也就是可复用性强不强,这个过程是互相看的,如果是实习生一般是导师给看,这一般会涉及到绩效,和转正之类的,其实是比较重要的

像一些文章会写的,什么设计模式之类的,我觉得一般就是在这里进行体现,虽然我是不怎么用的,可能我写的就不怎么优雅哈哈哈哈

我们一般是下午进行CR,时间是一整个下午左右,基本上时间只多不少,还是比较看重这方面的

打包

其实打包这个大家比较熟悉,我们知道的就有很多,比如vite、webpack

其实这么说也不对,我觉得也是大家的一个误区,就是会拿vitewebapck来进行打包工具方面的比较

但事实上vite本质上不是为了打包的,如果真要比较的话也是比较rollupwebpack

因为后两者才是打包工具,来进行代码的压缩、合并等操作

vite一般会问一些:为什么vite快啊之类的

也可以问它和webpack的区别,但是拿它和webpack比较我觉得是不妥当的,不知道这也是不是大家的一个误区

我们也会发现,现在的很多业务项目还是采用的webpack来进行打包,因为它对HTML、CSS、以及很多框架较为熟悉,而且不需要进行单测。

而在我们上面写的,工具、SDk等开发中,我们多数都是逻辑,封装,不涉及上面的那些,而且会进行单测,这时候会选择用rollup

然后关于打包的配置项,其实也没什么好说的,很多都是和优化相关的了,除了优化相关的,我们基本上只关注SourceMap即可

监控

前端监控不知道大家具体有没有开发过,但是相信大家大部分是听说过的

这里我做过B端和C端的监控,基本上就是错误监控行为监控性能监控

错误监控我们比较容易理解,比如网站哪里出错了,我们可以通过监控平台进行上报,定位到哪一行的代码出现了问题(这里就和上面的SourceMap对应上了),然后一般会搭配类似于邮件预警,比如企业微信飞书等平台,优势就不用多说了

监控平台的选择很多样,例如Sentry,或者Prometheus 搭配 Grafana等等,当然,也有很多公司选择自己开发平台,都是可以的

只要设计好SDK即可

同时性能和行为我们需要关注一些指标,然后做出直观的可视化报表等

例如

  1. 首次内容绘制 (First Contentful Paint,FCP)
  2. 最大内容绘制 (Largest Contentful Paint,LCP)
  3. 首次输入延迟 (First Input Delay ,FID)
  4. 交互到绘制延迟(Interaction to Next Paint,INP)
  5. 累积布局偏移 (Cumulative Layout Shift,CLS)
  6. 第一字节时间 (Time to First Byte,TTFB)

我们可以通过web-vitals搭配Performance API 获取标准化的用户体验指标。

还有

  • UV访问数(Unique Visitor)
  • PV访问来量(Page View)
  • 记录用户在页面的停留时间

等等数据需要我们采集

这个时候SDK显得尤为重要

这就我们需要关注SDK的接入设计SDK的运行设计,然后数据上报的时候数据的过滤啊,多端的适配啊,等等

优化

性能优化貌似是前端这两年的热门话题,最简单的,我们打包的时候可以进行打包分析,比如webpack-bundle-analyzer,或者你是vite的话就用rollup-plugin-visualizer

然后我们可以直观地看到各个库的打包体积的占比,然后呢就用CDN什么的优化,之类的

其实很多优化手段大家都知道,文章也比较多,如果我想具体讲的话,又得开一篇长文,这里我们只说一下一个项目,优化的完整流程是什么样子的

  1. 性能指标设定
  2. 性能标准确定
  3. 收益评估
  4. 优化手段
  5. 立项
  6. 优化实践

当然,也有一些专业的说法,例如RFC,大家的步骤可能有出入,但是又相似

这里其实我主要想说的是,一个工程化做的好的团队,优化是单独的,很重要的一环,并不是我们开发中随手优化的

性能优化是需要时间和成本的,需要多方地评审和收益评估,如果没有实际指标为目的进行盲目优化,是无法得到其它部门和领导的肯定的

甚至我们每个优化的环节都会进行验证、量化、和评估

而且不光是我们常见的业务场景需要优化,在可视化方面,优化更是让人头疼,比如canvas性能优化fps掉帧一直是大问题,而webgl更不用说了,比如LOD优化等等,现在也是面试也越老越爱问了

沉淀

这里的沉淀不只是说个人的沉淀,作为工程化的一环,团队的沉淀是很重要的

比如我们之前会搭建自己公司的知识库,比如直接用wolai这种的平台搭,也可以自己搞一个

然后定期开技术周会,现在有点记不清了,我记得当时是一周一次,然后需要出对应的文章,就类似于现在的技术文章一样,然后放到内部库里面(每篇文章都算绩效,这很重要!)

然后开发出通用性较强的库和工具也算(都算绩效!)

也可以说是技术交流的一种,把自己了解的新技术分享给大家,因为大家都了解的话也能更好地进行技术评审,没准下一次就用你推荐的这个库了呢

这种制度会让开发的小伙伴更喜欢去做一些提升自身能力的事情,也更能为团队赋能

结尾

其实工程化真的是一个比较灵活的概念,大家不要理解的太过死板

只要做的工作对项目、对团队有长久的有益影响,其实都算是工程化

这篇文章旨在给大家梳理一下自己对工程化的误区,给大家一些方向,并不意在精讲每个环节,因为每环都是很重要和复杂的,需要单独拿出来讲

我个人理解,工程化有利于提升自己的技术广度,也是成为架构的必修课

当然,这里我没有写CICD的内容,一是在工作中这不是我由我负责的,我做的都是构建等简单工作,二是因为我觉得运维和部署放在工程化中过于牵强

最后,前端工程化似乎已经成为了一种方向,也是面试中较为加分的点,那么重要性就不言而喻了,希望这篇文章能帮助到大家

近期都比较忙,只能晚上偶尔抽出时间来写文章,所以简短了些

欢迎大家进行讨论,不懂的可以留言,我会尽量回复的

以及写文章的时候有哪部分我一下子没想起来的,我在后面慢慢补充上去,如果需要每部分单独出文章的,大家可以说先出哪一块的,慢慢来~

另外,不做收费项目,不接单,不卖课,没那个实力也不想做,单纯分享,所以理性评论蟹蟹~

相关推荐
王哲晓8 分钟前
第三十章 章节练习商品列表组件封装
前端·javascript·vue.js
fg_41111 分钟前
无网络安装ionic和运行
前端·npm
理想不理想v13 分钟前
‌Vue 3相比Vue 2的主要改进‌?
前端·javascript·vue.js·面试
酷酷的阿云22 分钟前
不用ECharts!从0到1徒手撸一个Vue3柱状图
前端·javascript·vue.js
微信:1379712058725 分钟前
web端手机录音
前端
齐 飞30 分钟前
MongoDB笔记01-概念与安装
前端·数据库·笔记·后端·mongodb
神仙别闹1 小时前
基于tensorflow和flask的本地图片库web图片搜索引擎
前端·flask·tensorflow
GIS程序媛—椰子2 小时前
【Vue 全家桶】7、Vue UI组件库(更新中)
前端·vue.js
DogEgg_0012 小时前
前端八股文(一)HTML 持续更新中。。。
前端·html
ZL不懂前端2 小时前
Content Security Policy (CSP)
前端·javascript·面试