webpack实践总结

  一、Loader写法及执行顺序

从webpack2起,loader的格式如下:

 module: {
rules: [ {test:
/\.css$/, use: ['style-loader','css-loader']}, ] }
webpack1中的写法如下:
module: {
        loaders: [
            {
                test: /\.css$/,
                loader: 'style-loaer!css-loader'
            }
        ]
}
不管采用哪种写法,需要记住的是loader的执行顺序是从右往左

 二、根据模板生成html文件并自动插入脚本和样式的地址

使用html-webpack-plugin插件可达到这一目的。html-webpack-plugin插件与chunk概念紧密相联

所谓的chunk无非就是代码段,假设入口为index.js,在index.js中导入了a.js和b.js,那么打包出来就会形成一个name为index的chunk,chunk的内容是这三个文件合起来的内容

该插件不是webpack自带的,需要先安装到开发环境( npm html-webpack-plugin --save-dev),然后在webpack配置文件中有几个关键的配置项:

const htmlPlugin = require('html-webpack-plugin')
module.exports = {
    plugins:[
      new htmlPlugin({
        filename: '最终输出的html文件地址',
        template: '模板文件地址',
        hash:false,
        chunks: ['index','common']
      })
    ]
  }

hash:为true时在html中插入的文件地址格式会变为xxx.js?a3c9073cfd20130af5e3,生成hash的主要作用是用来处理浏览器缓存

chunks:可选属性,要插入哪些chunk生成的文件,如果未指定,则把所有的chunk形成的文件都插入。

在多页面中通常每个页面都有一个js做为入口文件,index.html使用index.js,user.html使用user.js,这里有两个入口,打包出来会形成两个chunk,分别为index和user

    entry:{
      index:rootPath+'/src/js/index.js',
      user:rootPath+'/src/js/user.js'
    },
    output: {
      filename: 'js/[name].js',
      path: rootPath+'/dist/'
    },

生成index.html时,我们显然不希望把user.js也引用进去,所以这时就必须要指定使用哪些chunk

如果要生成多个html,则需要在plugins数组中创建多个htmlPlugin实例

使用ExtractTextPlugin插件提取的css文件会自动添加到html中

指定了chunk时,如果使用CommonsChunkPlugin提取了公共代码,如果未在配置项中添加该chunk的名字,则生成的html不会插入公共代码文件

假设在html模板中已经手工插入了一些css和js文件,生成的文件会插入到这些文件之后

<link href="css/bootstrap.min.css" rel="stylesheet">xxxxxxxxx自动插入的链接地址在这里**********

  三、未打包的样式和脚本也想自动插入到html中  

在上面例子中我们把打包生成的文件自动插入到了html中,那么不参与打包的文件该怎么处理呢?如果我们采用手动插入方式,那么如果在开发环境时不使用cdn,在生产环境要使用cdn时,不是得手工去改html中的链接吗。

html-webpack-include-assets-plugin插件就是干这事的,它是对html-webpack-plugin的增强
安装好后需要使用const htmlIncludeAssetsPlugin = require('html-webpack-include-assets-plugin');导入模块
然后在webpack.config.js的plugins中添加一个插件实例
      new htmlIncludeAssetsPlugin({
        assets: ['js/lib/jq.js'],
        append: false, //false,添加到html-webpack-plugin生成的链接之前,true为之后
        hash:true, //是否在生成的文件地址后加hash,默认为false
        publicPath:'' //自定义publicPath,如果省略或为空则使用output项中指定的publicPath
      })

 该插件的实例会对所有的html-webpack-plugin实例起作用,也就是在所有生成的html中都插入相应的代码,如果只想在指定的html中追加,可以指定一个file属性

点我查看配置说明

四、项目使用jquery及插件的最佳实践

不管是我们以往的多页面还是vue、react这种mvvm框架中,都建议直接按如下方式使用:

1.在html中直接引入jquery及相应的插件,这样子在代码中就可以正常使用jquery以及相应的插件了

2.如果需要在代码中使用es6的模块导出功能import $ from 'jquery'或者cmd方式加载var $ = require('jquery'),那么你需要把$变量暴露给webpack,按如下方式进行配置

externals: {
    jquery: 'window.$'
}

externals的使用场景如下:当我们想引用一个库,然后想在代码中使用cmd或es6的模块引入,加但是又不想让webpack打包,这时就可以使用该配置项。

此步骤不是必须的,不使用es6 import或cmd require并不影响使用jquery及插件

3.如果是自己编写的插件,可以使用es6的import './jqPlugin/globalJq.js'方式导入,此方式会把globalJq.js的代码打包进项目的js中

4.会把jquery打包到项目js中的几种方式

  • 使用expose-loader
    step1:安装到生产环境:npm install  jQuery expose-loader --save
    step2:在配置文件中添加一个loader
    {
        test: require.resolve('jquery'),
        loader: 'expose?jQuery!expose?$'
     }

     step3,在需要使用jquery的文件中导入模块即可

    import $ from 'expose?$!jquery'
    import 'jquery-ui' //插件可用  

    此种方式在使用layer.js这个弹层库时会出错

  • 使用ProvidePlugin
    该插件是webpack自带的,不需要单独安装
    step1:npm install jQuery --save
    step2:在webpack配置文件的插件选项中添加一个webpack.ProvidPlugin实例(注:webpack是在文件头声明的,const webpack=require('webpack'))
  • new webpack.ProvidePlugin({
      $: "jquery",
      jQuery: "jquery"
    }),

    step3:接下来就是直接使用$了,不需要再导入模块

    import 'jquery-ui' //引入jquery-ui插件
    $('#app').text()

    该插件的作用是自动加载模块。 当 使用未赋值的变量时, module 就会自动被加载,并且 identifier 会被这个 module 输出的内容所赋值。上面的变量是$,对应的module是我们安装的jquery模块。
    缺点是没有全局上下文,$变量没有声明就可以使用,当使用eslint时无法验证语法错误

5. 为什么推荐直接在html中引入jquery及相应的插件

采用上面第4条中的做法,在打包时会出现一系列的问题,具体表现在:

1.如果多个文件都使用了jquery,那么打包时,每个文件中都会插入jquery库的代码,代码重复,然后你会想到第2条的抽取公共代码方法

2.使用CommonsChunkPlugin插件把多份代码中都使用到的代码提取为独立文件,这种做法在每次打包时都会计算哪些是公共代码,项目大时找包速度很慢。

3.为了解决打包性能,得改用DllPlugin和DllReferencePlugin插件,打包速度解决了,但是还是得手动把xxx.dll.js插入到html中。(看不明白不要紧,后续会讲到该插件)

看到了吗,使用第4条中的方法绕来绕去最终还是得在html中插入提取到的公共代码或xxx.dll.js,做了一系列的工作,实际上等于脱了裤子放屁

  五、实时编译并查看运行结果(HRM)

主要使用webpack-dev-server,安装好该包后,需在package.json中和webpack.config.js中进行配置。

首先在package.json的scripts节点增加一个命令,我习惯叫dev,然后在命令行中就可以使用 npm run dev来启动调试服务器了

  "scripts": {
    "dev": "webpack-dev-server --open --inline --hot
  },

open--参数表示启动服务器后自动打开网页

inline 和hot配合实现热刷新,hot参数必须写在这里,在webpack.config中配置无效

接下来在webpack.config中增加一个devServer配置项:

  devServer: {
    contentBase:'dist', //网站文件目录,一般指向打包输出目录
    historyApiFallback: true,//不跳转
    progress: true
  },

更详细的配置,点我

  六、如何处理sourcemap?

主要使用devTool选项,最常用的有以下几种:

上述选项由上到下打包速度越来越快,不过同时也具有越来越多的负面作用,较快的打包速度的后果就是对打包后的文件的的执行有一定影响。

生成source map的目的是为了方便调式,出错时能定位到最原始的资源,不管该资源是react的jsx,还是vue的单文件,因此使用eval选项并没有意义,这也是在上表中没有列出的原因

那为什么也不使用inline-source-map选项呢?主要还是因为打包速度慢,文件体积变大

总结:

在开发环境中我们使用:cheap-module-eval-source-map

在生产环境中我们使用:cheap-module-source-map。

  七、css相关处理

在webpack中所有的东西都是模块,css也不例外,只有将css视为模块,才能在webpack中进行打包和压缩,才能自动插入到相应的html中,才能将css转成js对象方式来使用(vue中有该技术)。

1.css-loader和style-loader

css-loader  主要的作用是把css当作模块使用,然后就可以在js中使用 import 'xxx.css'导入样式表,然后参与打包

style-loader 主要的作用是把js中导入的css模块插入到html中形成一个<style>xxxx</style>

step1:安装模块

npm install  style-loader css-loader --save-dev

step2:webpack中编写loader

 
 
module: {
    rules: [
      { test: /\.css$/, use: [
{ loader: 'style-loader'}, {loader: 'css-loader',options: { modules: true}} ] } ] }
 

 2.使用post-loader+autoprefixer自动为css加前缀

某些css属性,要为不同的浏览器加不同的前缀,手动添加相应的前缀是个苦差事,post-loader可以很好的解决这个问题,我们只需写一个正常的样式

div
{
   transform:rotate(7deg);
}

使用post-loader后会自动转成

div
{
transform:rotate(7deg);
-ms-transform:rotate(7deg);     /* IE 9 */
-moz-transform:rotate(7deg);     /* Firefox */
-webkit-transform:rotate(7deg); /* Safari 和 Chrome */
-o-transform:rotate(7deg);     /* Opera */
}

网上很多文章比较坑,会告诉你用autoprefixer插件或用post-loader插件,实际上两个插件都需要安装!

npm install  autoprefixer  post-loader --save-dev

3.使用less-loader来编译.less文件

4.使用extract-text-webpack-plugin插件来提取style-loader向页面中插入的样式

使用前需要先安装该插件,然后使用const ExtractTextPlugin = require("extract-text-webpack-plugin");//导入模块,最后在plugins数组中创建一个实例

new ExtractTextPlugin('css/[name].css'),  

 使用name属性时,从入口中index.js中抽取出来后的文件是index.css,当然也可以指定为一个固定的名字比如page,css

 当我们指定css/xxx.css时,最终的生成路径实际上是webpack的output.path+'css/xxx.css'

5.相关的配置

注意use中的loader顺序,不要写反了

        {
          // 用正则去匹配要用该 loader 转换的 CSS 文件
          test: /\.css$/,
          use: ExtractTextPlugin.extract({
            fallback: "style-loader", // 编译后用什么loader来提取css文件
            use: ['css-loader?minimize=true','postcss-loader']
          })
        },

6.css压缩处理

需要使用optimize-css-assets-webpack-plugin插件来专门处理css。如果你搜网上那些教程,一般会告诉你css-loader有压缩属性,又或者告诉你你在pageage.json中创建一个打包的scrpits命令,配置如下:

  "scripts": {
    "build": "webpack -p",
  },

假如你按他们的方法来打包,最后你发现你的css文件中的代码还是原封不动的,根本就没有删除空格,也没有删除注释!

 
插件比较简单,实例化时最常用的配置如下:
    new OptimizeCssAssetsPlugin({
      cssProcessor: require('cssnano'),
      canPrint: true
    })

  八、区分开发环境和生产环境

主要的工作有以下几步:
1.写一个各种环境都会用到的配置文件,假设叫webpack.common.js,再分别建各个环境的配置文件,例如webpack.dev.js和webpack.prod.js
2.各自的配置文件中,使用webpack自带的webpack-merge函数来合并配置,然后使用webpack.DefinePlugin来定义在该环境下可供全局共享的变量,一个完整的配置例子如下:
const common = require('./webpack.common.js');
const merge = require('webpack-merge');
const CleanWebpackPlugin = require('clean-webpack-plugin');
const UglifyJSPlugin = require('uglifyjs-webpack-plugin');
const webpack=require('webpack')
const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');
const path=require('path')
const rootPath=path.resolve(__dirname,'../')
//const DllReferencePlugin = require('webpack/lib/DllReferencePlugin');
const prodConfig={
  plugins:[
    new webpack.DefinePlugin({
      'process.env': JSON.stringify({env:'development','BASE_API':'http://www.baidu.gov.cn'})
    }),
    new CleanWebpackPlugin(['build'], {
      root: '', // An absolute path for the root  of webpack.config.js
      verbose: true,// Write logs to console.
      dry: false // Do not delete anything, good for testing.
    }),
    /*
    new DllReferencePlugin({
      manifest: require('../dist/vendor.manifest.json'),
    }),
    */
    new UglifyJSPlugin(),
    new OptimizeCssAssetsPlugin({
      cssProcessor: require('cssnano'),
      canPrint: true
    })
  ]
}
module.exports=merge(common,prodConfig)

需要注意的是DefinePlugin中某个项的值的写法,假如你想在代码中访问process.env里存储的内容,那么在定义时必须使用Json.stringify('prod'),或者是'"prod"',而不是'production'

3.修改package脚本,让webpack使用指定的配置
  "scripts": {
    "build": "webpack --config webpack.prod.js",
    "dev": "webpack-dev-server webpack.dev.js",
  },

 需要注意配置文件的路径,如果不是在根目录下,而是在config文件夹下,则应修改为

"build": "webpack --config config/webpack.prod.js",
 
 

猜你喜欢

转载自www.cnblogs.com/94pm/p/9619609.html