看看前端工程化,我们是这样做的

前言

  前端潮流,浩浩汤汤。一时间,各种框架如:node、vue、react,各种概念如:模块化、工程化、TDD等,如雨后春笋般涌现。我司不甘人后,及时对技术栈做了更新,wap端从传统的PHP架构,更新为node+vue的单页面应用架构。
  在重构的过程中,我们不能避免考虑如下的问题:
  (1)开发时,代码按模块划分文件以方便管理。上线时,减少代码文件数量以节省请求开销。
  (2)开发时,代码规范命名、详细注释以方便开发者阅读。上线时,代码越短越好减少文件体积以方便机器获取。
  (3)开发时,编写最简单的代码以提高开发效率。上线时,以多种方式实现代码以兼容不同浏览器运行。
开发环境与生产环境有着不同的需求,如下图:


开发环境VS线上环境

  两者需求的实现方式是矛盾,如:线上要求文件越少越好,以减少HTTP请求的开销。开发要求按模块划分多文件,以便于开发时的管理。前者的目的是减少HTTP请求,后者却引起更多的HTTP请求,影响页面性能。

如今,我司通过webpack等自动化打包工具,完成从开发的源代码到线上的生产代码的自动化构建。


webpack构建过程

本文以上述开发与生产的矛盾为出发点,基于webpack4实现前端工程优化

一、CSS

webpack提供了相应的plugin、loader实现对css文件的压缩、抽离、兼容性处理

1、压缩

optimize-css-assets-webpack-plugin,示例如下:

const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin')//压缩css插件

module.exports = merge(common, {
  plugins: [
    new OptimizeCssAssetsPlugin(),
  ]
})

2、抽离CSS文件

插件mini-css-extract-plugin根据require.ensure的chunk,将页面的css代码抽离到单独的css文件中。

const MiniCssExtractPlugin = require('mini-css-extract-plugin')//提取css到单独文件

module.exports = merge(common, {
  mode: 'production', // 压缩代码
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          {
            loader: MiniCssExtractPlugin.loader, // 提取css到外部文件中
            options: {
              publicPath: '/dist/css/'
            }
          },
          'css-loader',
          'postcss-loader'
        ]
      }
    ]
  },
  plugins: [
    new MiniCssExtractPlugin({
      filename: 'css/[name].css',//将输出文件放在dist/css文件夹下
      chunkFilename: 'css/[id].css'//按需加载的文件将输出文件放在js文件夹下
    })
  ]
})

3、兼容性处理

PostCss是一个样式处理工具,它通过自定义的插件和工具生态体系来重新定义css。PostCss在webpack通过postcss-loader实现,配合autoprefixer为样式添加前缀,兼容不同浏览器。示例如下:

//postcss.config.js
module.exports = {
  plugins: [
    require('autoprefixer')
  ]
}
//webpack.common.js
module.exports = merge(common, {
  module: {
    rules: [
      {
        test: /\.css$/,
       use: [
          {
            loader: 'style-loader',
          },
          {
            loader: 'css-loader',
            options: {
              importLoaders: 1,
            }
          },
          {
            loader: 'postcss-loader'
          }
        ]
      }
    ]
  }
})

二、JS

1、压缩

Webpack4 默认提供的 UglifyJS 插件,只需要设置mode为production即可。

module.exports = merge(common, {
  mode: 'production', //开启生产环境的默认设置
}

但由于 UglifyJS 采用单线程压缩,速度较慢。我司pms后台管理系统采用支持并行压缩的 webpack-parallel-uglify-plugin 插件,构建速度提高了30%。在配置选项中,我们可以将空格、制表符、注释、console等去除,以实现更好的压缩效果。同时避免漏删调试console代码的问题。实现代码如下:

const ParallelUglifyPlugin = require('webpack-parallel-uglify-plugin');
module.exports = merge(common, {
  optimization: {
      minimize: false//关闭默认的UglifyJS 压缩功能
  },
  plugins: [
    new ParallelUglifyPlugin({
      cacheDir: '.cache/',
      uglifyJS:{
        output: {
          /* 是否输出可读性较强的代码,即会保留空格和制表符,默认为输出,为了达到更好的压缩效果,
          可以设置为false*/
          beautify: false,
          /*是否保留代码中的注释,默认为保留,为了达到更好的压缩效果,可以设置为false*/
          comments: false
        },
        compress: {
          /*是否在UglifyJS删除没有用到的代码时输出警告信息,默认为输出,可以设置为false关闭这些作用
          不大的警告*/
          warnings: false,
          /*是否删除代码中所有的console语句,默认为不删除,开启后,会删除所有的console语句*/
          drop_console: true,
        }
      }
    }),
  ]
})

2、分包

默认地,webpack会将所有的js打包成一个boundle.js文件,这个文件一般有几百k到几M。首屏加载时,boundle.js包含了很多并未用得上的代码。因此,我们可以利用webpack的require.ensure语法实现分包,以提高首屏加载的速度。demo使用vue的示例如下:

import Vue from 'vue'
import vueRouter from 'vue-router';
// 将vueRouter和vue绑定起来
Vue.use(vueRouter)

// 导入.vue组件对象,webpack根据chunk参数,将相同chunk名的组件打包在一起
const index = resolve => {require.ensure([], () => {resolve(require('src/page/index.vue'))},'index')}
const invest = resolve => {require.ensure([], () => {resolve(require('src/page/invest.vue'))},'invest')}
const help = resolve => {require.ensure([], () => {resolve(require('src/page/help.vue'))},'help')}
const wealth = resolve => {require.ensure([], () => {resolve(require('src/page/wealth.vue'))},'wealth')}

// 1.0.3 定义路由规则
var router = new vueRouter({
  routes:[
    {name:'default',path:'/',redirect:'/index'},
    {name:'index',path:'/index',component:index,meta:{title: '分利宝官网-专注小微经济实体融资的网络借贷信息中介服务平台 '}},
    {name:'invest',path:'/invest',component:invest,meta:{title: '投资页面'}},
    {name:'help',path:'/help',component:help,meta:{title: '帮助中心 '}},
    {name:'wealth',path:'/wealth',component:wealth,meta:{title: '我的财富'}},
  ]
});

export default router;

3、依赖包单独处理

对于依赖的第三方库,比如vuevuex等,我们可以使用DllPlugin,将依赖库预先打包,存在项目的静态资源文件夹。webpack打包项目代码时,只需要打包我们的业务代码,并根据DllReferencePlugin查找已打包的依赖库。这样就可以快速的提高打包的速度。代码配置如下:
1.新建webpack.dll.config.js,用于打包依赖库。

//webpack.dll.config.js
const path = require('path');
const webpack = require('webpack');
module.exports = {
  mode:'production',
  entry: {
    echarts: ['echarts'],
    vue:['vue'],
    router:['vue-router'],
    vuex:['vuex'],
    polyfill:['babel-polyfill']
  },
  output: {
    path: path.join(__dirname, './static/dll/js'), //放在项目的static/js目录下面
    filename: '[name].dll.js', //打包文件的名字
    library: '[name]_library' //可选 暴露出的全局变量名
  },
  plugins: [
    new webpack.DllPlugin({
      path: path.join(__dirname, './static/dll/manifest', '[name]-manifest.json'), //生成上文说到清单文件,放在当前build文件下面,这个看你自己想放哪里了。
      name: '[name]_library'
    }),
  ]
};
//webpack.prod.js
const AddAssetHtmlPlugin = require('add-asset-html-webpack-plugin');
module.exports = merge(common, {
  plugins: [
    new webpack.DllReferencePlugin({
      context: path.resolve(__dirname),
      manifest: require('./static/dll/manifest/vue-manifest.json')
    }),//读取包含第三方库映射关系的vue-manifest.json文件,读取第三方依赖
    new AddAssetHtmlPlugin([{
      filepath: path.resolve(__dirname,'./static/dll/js/vue.dll.js'),
      includeSourcemap: false,
      hash: true,
    }]),//将依赖库的dll包插入到index.html中
  ]
})

2.修改webapck.prod.js

const AddAssetHtmlPlugin = require('add-asset-html-webpack-plugin');//将DLL文件插入到html模板的插件
plugins: [
    new webpack.DllReferencePlugin({
      context: path.resolve(__dirname),
      manifest: require('./static/dll/manifest/vue-manifest.json')
    }),//DllReferencePlugin插件读取vendor-manifest.json文件,查找对应的依赖包dll文件
    new AddAssetHtmlPlugin([{
      filepath: path.resolve(__dirname,'./static/dll/js/polyfill.dll.js'),
      includeSourcemap: false,
      hash: true,
    }]),//用于dll包插入到index.html
  ]

3.在package.json中增加一条脚本:

"scripts": {
    "build:dll": "webpack --config webpack.dll.config.js"
  },

执行npm run build:dll,生成如下文件


打包出来的依赖库

在依赖库未更新的情况下,可以一直沿用以上文件。后续项目打包的时候,不需要再执行build:dll的脚本。

4、处理线上旧缓存

因为缓存,web应用的性能、体验大大提高。但当我们需要部署新代码上线时,常常因为缓存问题,导致文件不能及时更新,测试同学追着投诉代码没生效。webpack的html-webpack-plugin插件很好地解决了这个问题。示例代码如下:

//webpack.common.js
module.exports = {
  entry:{app: './src/index.js'},
  output: {
    filename: 'js/[name].[hash].js',//将输出文件放在js文件夹下,以哈希值命名,解决线上缓存的问题
    path: path.join(__dirname, './dist')
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: 'index.html',//引用的模板
      filename: 'index.html'//生成模板的名字
    }),
  ]
}

插件根据template文件,生成一个带有output里filename的script标签,因为以哈希值命名,每次部署线上的文件名称都不同,解决了缓存的问题。

三、 环境配置

在实际项目中,根据开发流程,代码需要运行在不同的环境。如我司有本地环境、测试环境、准线环境、生产环境。不同环境需要调用不同地址的接口。我司在移动端重构前,需要运维手动修改配置文件,再部署到服务器。但多一个人手操作的流程,就多一分出错的风险。如今,通过package.json文件配置npm脚本,不同环境跑不同的脚本。如下所示:

"scripts": {
    "dev": "webpack-dev-server --inline --hot --open --port 8098 --config webpack.dev.js",
    "build": "webpack --config webpack.prod.js",
    "build:dll": "webpack --config webpack.dll.config.js"
  },

不同的webpack配置文件,需要设置不同的环境变量,webpack提供了DefinePlugin满足我们的需求。

module.exports = merge(common, {
  plugins:[
    new webpack.DefinePlugin({
      'process.env': {
        NODE_ENV: '"DEVELOPMENT"'//webpack构建后生成一个全局的环境变量process.env.NODE_ENV,根据此变量,调用对应的接口,应用不同的配置
      }
    })
  ]
})

当npm run dev时,在被调用的webpack.dev.js中 NODE_ENV设置为'"DEVELOPMENT"'。
当npm run build时,在被调用的webpack.prod.js中 NODE_ENV设置为'"PRODUCTION"'。
我们可以方便地在全局拿到process.env.NODE_ENV的值。接下来就根据拿到的值,调用对应的接口、配置参数了。
运维同学再搭配jenkins,写个脚本。前端代码合并到gitlab的分支就可以实现自动构建啦。

总结

全文使用webpack实践了前端工程优化,在构建项目、代码压缩、兼容性处理、环境配置等方面叙述了前端工程化在开发中的作用。然而,实际的项目优化需求要根据项目的痛点来定。如何分割代码、是否要抽离样式文件,是否要引入规范。需要不断的实践、试错。愿各位同学砥砺前行,找到你们的最优实践。

本文所用到的demo任意门,如果能帮到你,请不吝赐个star。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349

推荐阅读更多精彩内容

  • GitChat技术杂谈 前言 本文较长,为了节省你的阅读时间,在文前列写作思路如下: 什么是 webpack,它要...
    萧玄辞阅读 12,681评论 7 110
  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 11,060评论 0 21
  • 在现在的前端开发中,前后端分离、模块化开发、版本控制、文件合并与压缩、mock数据等等一些原本后端的思想开始...
    Charlot阅读 5,433评论 1 32
  • 写在开头 先说说为什么要写这篇文章, 最初的原因是组里的小朋友们看了webpack文档后, 表情都是这样的: (摘...
    Lefter阅读 5,279评论 4 31
  • 最近在重听宁向东老师的管理课,收获满满。付诸实践更重要。 上班实在是人浮于事,下午折腾个入库出库流程没个结果,管事...
    NemoX阅读 106评论 0 0