我爱编程简web

webpack使用体验

2018-02-06  本文已影响0人  吴豆腐

node知识

path.resolve

path.resolve(from[...pathname], to)将参数to位置的字符解析到一个绝对路径里。
__dirname 当前文件目录绝对路径
__filename 当前文件全路径
demo示例:(当前目录: D:\www\programs\react-prod\config)

// 相对路径根据当前位置绝对路径解析
// ../匹配上一层
// ./ 或者 没有./匹配当前路径
// D:\www\programs\react-prod\config\dist
path.resolve('./dist')
// D:\www\programs\react-prod\dist
path.resolve('../dist')
// D:\www\programs\react-prod\config\www\dist
path.resolve('www/demo', '../dist')
// D:\dist绝对路径直接返回
path.resolve('/dist')

// 如果只传递一个参数,那么相对路径将基于当前命令的执行路径
输出

console.log(path.resolve('./dist'))
console.log(path.resolve(__dirname, './dist'))

当在D:\www\programs\react-prod路径下执行时,分别返回

D:\www\programs\react-prod\dist
D:\www\programs\react-prod\script\dist

当在D:\www\programs\react-prod\script路径下执行时,分别返回

D:\\www\\programs\\react-prod\\script\\dist
D:\\www\\programs\\react-prod\\script\\dist

所以为了表现一致,path里面解析绝对路径,需要加上__dirname


webpack知识

context
配置基础目录,使config中的相对路径基于这个目录,这样,不管webpack配置文件放在哪里,我们在文件内部引用外部文件时,都可以根据一个相同的基础目录解析文件,只需修改config.context一个地方就可以了。

entry入口

用法:

  1. 单入口: entry: string|Array<string>,传入数组会将数组中的文件作为统一一个入口一起打包成一个文件
  2. 多入口: 用法:entry: {[entryChunkName: string]: string|Array<string>}根据入口打包成多个js文件

output输出

在 webpack 中配置 output 属性的最低要求是,将它的值设置为一个对象,包括以下两点:

  1. filename 用于输出文件的文件名。
  2. 目标输出目录 path 的绝对路径。

常用loaders

1.css-loader

css加载器 css-loader, style-loader
css-loader 解释(interpret) @import 和 url() ,会 import/require() 后再解析(resolve)它们
style-loader用来将解析出来的css内容添加到页面的style标签里面。但是一般情况下我们都会将css样式与js文件分离,这样可以有效减小代码体积。2.66kb -> 816bytes+27bytes
css-loader+style-loader一般需要结合两个plugin一起使用,分别用于将css分离和压缩

// 用于提取css的plugin
const ExtractTextPlugin = require('extract-text-webpack-plugin')
// 用于压缩css的plugin
const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin')
...
// module.rules[num]
{
    test: /\.css$/,
    // 它会将所有的入口chunk(entry chunks)中引用的 *.css,
    // 移动到独立分离的 CSS 文件
    // css bundle 与 js bundle 并行加载,加快页面初始化
    use: ExtractTextPlugin.extract({
      fallback: 'style-loader',
      use: 'css-loader'
    })
    // style-loader用来将css-loader解析(import,url()等)出来的css
    // 插入到页面的<style>标签里面,没有则无法正常引用
    // 使用etp时则作为降级处理
    // use: ['style-loader', 'css-loader']
}
...
plugins: [
    // name为入口里面的名字,将抽离的css合并成文件
    // 对每个入口chunk都生成一个对应的文件
    // 所以当你配置多个入口 chunk 的时候
    // 必须使用[name],[id]或[contenthash]
    new ExtractTextPlugin('css/[name].css'),
    // 压缩css
    new OptimizeCssAssetsPlugin({
      // 匹配需要压缩的文件
      assetNameRegExp: /\.css$/g,
      // 压缩使用的插件
      cssProcessor: require('cssnano'),
      cssProcessorOptions: { discardComments: {removeAll: true } },
      canPrint: true
    })
]

2.file-loader
file-loader用来解析资源文件,可以自定义解析生成的文件名,路径等等,用来处理css中的background-image以及js中import一个img等引用资源的情景。
file-loader存在一个很大的坑就是,我们往往需要使用相对路径去解析打包文件中设计的图片资源,并且将打包生成的css,images分别放在不同的目录,比如我们规定解析生成的img的路径名称为:assets/images/demo.png,那么不管是在css还是在js的img引用中,引用路径都会是'assets/images/demo.png',在html中,由于本身目录结构与asset平级,可以顺利引用,但是在css中就不行了,引用路径就会变成dist/assets/css/assets/image/demo.png。emmm,自然是不行的。在网上找了一大圈,全是什么乱七八糟的,要么牛头不对马嘴,要么自娱自乐,要么强行装逼...真是无力吐槽。真正有用的信息总是被垃圾信息掩盖,不过费了九牛二虎之力,还是找到了行之有效的解决办法,传送门。这里利用了extract-text-webpack-plugin的publicPath属性,这个属性的作用是,重新设置loader解析出来的文件的publicPath。作用就是,比如你在css里面本来的引用路径是'assets/images/demo.png',通过设置publicPath,引用路径就变成了'../../assets/images/demo.png'。根据本例的路径,(返回到assets层,再返回到dist层)最终解析的路径就是'dist/assets/images/demo.png'。ok,至此,import、url()的路径都是正常的啦。网上有一种解决方案是使用绝对路径,额,大胸弟,我觉得这个很不妥吧,你能保证你的目录外面没有嵌套个几层?比如给咱的应用套个apapa的壳?(emmmm.很偏激,欢迎指正) 可以结合图片压缩plugin,比如压缩生成的雪碧图。

{
    test: /\.(png|svg|jpe?g|gif)$/i,
    use: {
      loader: 'file-loader',
      options: {
        name: 'assets/images/[name].[ext]'
      }
    }
}

// css-loader做如下修改
{
    test: /\.css$/,
    // 它会将所有的入口 chunk(entry chunks)中引用的 *.css,
    // 移动到独立分离的 CSS 文件
    // css bundle 与 js bundle 并行加载
    use: ExtractTextPlugin.extract({
      fallback: 'style-loader',
      // 定义文件内部引用的路径
      // 原路径加上../../(基于assets/images/)
      // 用来处理url文件引用
+     publicPath: '../../',
      use: 'css-loader'
    })
}

3.babel-loader
babel-loader的作用是在webpack里面使用babel。emmm....
用法如下

{
    test: /\.(js|jsx)$/,
    exclude: /node_modules/,
    use: {
      // 依赖babel-loader,babel-core
      // 等价于
      // loader: 'babel-loader?presets=env&compact=false',
      loader: 'babel-loader',
      options: {
        // 将es6的语法转换成es5
        presets: [
          ["env", {

            // 如果兼容性要求不高,可以添加target属性
            // 减少polyfill的代码量,并且直接使用es6新特性
            "targets": {
              "browsers": ["last 2 versions", "safari >= 7"]
            },
            // 交由 Webpack 来处理模块化(决定使用import/require)
            // 通过其 TreeShaking 特性将有效减少打包出来的JS文件大小867bytes->817bytes
            "modules": false
          }]
        ],
        // babel-plugin-transform-runtime
        // babel-runtime
        // 避免模块的重复引用,polyfills功能,修复es6高级语法不兼容问题
        // 与babel-polyfill的区别在于runtime会按需加载,不会污染全局
        plugins: ['transform-runtime'],
        // 缓存编译结果
        cacheDirectory: true,
        // 去掉多余的空行与换行符
        compact: true
      }
    }
}

4.ts-loader
使用ts开发时,需要使用ts-loader进行type check,但是ts-loader在执行检测的过程中,是单线程执行,这会造成编译时间巨长无比。在这里使用awesome-typescript-loader替代

{
    test: /\.tsx?$/,
    use: {
      loader: 'awesome-typescript-loader',
      options: {
        useBabel: true,
        babelOptions: {
          babelrc: false, /* Important line */
          presets: [
            ["env", { "targets": "last 2 versions, ie 11", "modules": false }]
          ],
          // polyfill
          plugins: ['transform-runtime'],
        },
        babelCore: "babel-core", // needed for Babel v7
        errorsAsWarnings: true, // 类型错误warning,而不是error
      }
},

常用插件

1.HtmlWebpackPlugin
该插件将为你生成一个HTML5文件,其中包括使用script标签的body中的所有webpack包

new HtmlWebpackPlugin({
  // 定义html文件的title,如果指定模板则无效
  title: '我的生涯一片无悔,想起那天下午夕阳下的奔跑,那是我逝去的青春',
  favicon: './assets/images/favicon.ico',
  template: './template/page.html',
  filename: 'index.html',
  // 只引入指定的入口文件生成的chunks,默认引入所有
  chunks: ['bar'],
  // 将生成的文件插入html中的位置
  inject: 'body',
  // 给生成的js,css添加一个唯一的hash
  // assets/js/bar.js?b34fce8721458861ac22
  hash: true,
  cache: true
  
  // 使用插件,丰富template
  // 将生成的文件插入html中的位置
  // html-webpack-template结合使用时需要置为false
  // 个人觉得不好用,不够直观,不玩了
  // inject: false,
  // template: require('html-webpack-template'),
  // appMountId: 'app',
}),

2.clean-webpack-plugin
清除文件夹,比如清除之前生成的dist

// 清理dist,默认基于__dirname,可以自己传参配置,
// 如果目录在root之外,则无法顺利清除
// root需要包含被清除目录
new CleanWebpackPlugin(['dist'], {root: path.resolve(__dirname, '../')}),

3.extract-text-webpack-plugin与optimize-css-assets-webpack-plugin
分离cs压缩css

// 它会将所有的入口 chunk(entry chunks)中引用的 *.css,
// 移动到独立分离的 CSS 文件
// css bundle 与 js bundle 并行加载
test: /\.css$/,
use: ExtractTextPlugin.extract({
  fallback: 'style-loader',
  // 定义文件内部引用的路径
  // 原路径加上../../(基于assets/images/)
  // 用来处理url文件引用路径不正确问题
  publicPath: '../../',
  use: 'css-loader'
})

// name为入口里面的名字,将抽离的css合并成文件
// 所以一个入口生成一个css文件,在HtmlWebpackPlugin中
// 将根据入口将对应的css文件绑定到html
// 对每个入口chunk都生成一个对应的文件
// 所以当你配置多个入口 chunk 的时候
// 必须使用[name],[id]或[contenthash]
new ExtractTextPlugin('assets/css/[name].css'),

// 压缩css
new OptimizeCssAssetsPlugin({
  assetNameRegExp: /\.css$/g,
  cssProcessor: require('cssnano'),
  cssProcessorOptions: { discardComments: { removeAll: true } },
  canPrint: true
})

4.new webpack.optimize.UglifyJsPlugin()
压缩打包后的文件
使用插件替代uglifyjs-webpack-plugin

// 压缩打包后的文件
new UglifyJSPlugin({
  // 生产环境使用source-map
  sourceMap: true
})

5.hard-source-webpack-plugin
缓存编译结果,加速编译,效果显著

// 缓存编译结果,缩短编译时间
new HardSourceWebpackPlugin(),

概念

webpack打包的代码分成三个部分,第一个是自己编写的代码,第二部分为引入的第三方库与依赖,第三个部分是webpack用来进行模块加载与逻辑解析(runtime)和模块交互的部分(mainfest)


上一篇下一篇

猜你喜欢

热点阅读