webpack3.x版本实战案例【基础配置篇】（一）

本文旨在通过一个一个实战例子来学习webpack如何配置，更加深入的学习webpack在实战项目中如何配置。

我们学习哪些配置呢？

【基础配置】

打包JS
编译ES6
编译typeScript
打包公共代码
代码分割和懒加载
打包css
打包less sass
提取css为独立文件
postCss的使用
js Tree-shaking
css Tree-shaking
图片处理（css中引入图片、base64编码）
压缩图片，自动合成雪碧图sprite、retina处理
字体文件处理
处理第三方JS库
生成HTML
HTML中引入图片
优化webpack配置

** 所有实际代码都可在github上查看：https://github.com/shiyou00/webpack **

webpack命令

webpack -h //帮助简写
webpack -v //webpack版本号
webpack <entry> [<entry>] <output> // 执行webpack输入输出命令
--config 指定将要执行的webpack配置文件 : webpack --config webpack.conf.dev.js 指定将要执行的webpack配置文件为 webpack.conf.dev.js
--env 指定运营环境
--watch 监测文件变化
--debug loaders打开调试状态
--devtool 开发工具生成sourceMap

打包JS

创建文件index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>打包JS</title>
</head>
<body>

<script src="bundle.js"></script>
</body>
</html>

创建文件app.js

import sum from './sum';
console.log('sum(1,7)=',sum(1,7));

创建文件sum.js

export default function (a,b){
    return a + b;
}

创建webpack.config.js

module.exports = {
    entry: {
        app : './app.js'
    },
    output: {
        filename : 'bundle.js' // filename : '[name].[hash:5].js'
    }
};

解释：filename: '[name].[hash:5].js' => [name]根据输入的文件名输出；[hash:5]输出五位hash值

然后执行webpack命令输出了bundle.js文件
打开index.html，并打开控制台就可以看到正确的输出了

---------------------------

编译ES6

需要使用的工具
Babel
- babel-loader
- babel/core

首先安装依赖

npm install -save-dev babel-loader @babel/core

主意：babel-loader babel-core 这些有强的版本依赖关系的，必须得版本对了运行才会对的。具体版本号在git上面的package.json中可以看到

Babel Presets

使用babel的什么规范打包
es2015
es2016
es2017
env : 包含2015到最近的版本的一个汇总，所以开发中常用这个

安装presets（使用什么就安装什么）

npm install @babel/preset-env --save-dev

app.js

let func = () => {};
const NUM = 45;
let arr = [1,2,4];
let arr2 = arr.map(item => item * 2);

console.log('new Set', new Set(arr2));

webpack.config.js

module.exports = {
    entry: {
        app: './app.js'
    },

    output: {
        filename: '[name].[hash:8].js'
    },

    module:{
        rules:[
            {
                test: /\.js$/,           // 使用正则匹配的文件名
                use: {
                    loader: 'babel-loader', // 使用的loader
                    options: {
                        presets: [
                            ['@babel/preset-env',{
                                targets : { // targets:指定符合哪些条件的范围内编译
                                    browsers:['> 1%', 'last 2 versions']
                                }
                            }]
                        ],
                    }
                },
                exclude: '/node_modules/' // 需要排除的文件
            }
        ]
    }
}

运行webpack，看下运行的文件的结果

可以看到已经成功的编译了ES6

【.babelrc】
配置babel的使用规则，把babel配置从webpack中拎出来

{
  "presets": [
    ["@babel/preset-env",{
      "targets" : {
        "browsers":["> 1%", "last 2 versions"]
      }
    }]
  ]
}

同时把webpack.config.js修改下

module.exports = {
    entry: {
        app: './app.js'
    },

    output: {
        filename: '[name].[hash:8].js'
    },

    module:{
        rules:[
            {
                test: /\.js$/,           // 使用正则匹配的文件名
                use: {
                    loader: 'babel-loader' // 使用的loader
                },
                exclude: '/node_modules/' // 需要排除的文件
            }
        ]
    }
}

运行下发现也是成功的。

正常配置只能兼容IE9+浏览器，那么要兼容IE8的浏览器要怎么办呢？
【Babel Polyfill】
全局垫片，为应用准备

安装：npm install babel-polyfill --save

直接在代码app.js中引入即可

import "babel-polyfill"; // 添加在最上面即可

然后运行下，发现也是成功的

【Babel Runtime Transform】
局部垫片，开发框架使用

安装：
npm install @babel/plugin-transform-runtime --save-dev
npm install @babel/runtime --save

然后配置.babelrc文件

{
  "presets": [
    ["@babel/preset-env",{
      "targets" : {
        "browsers":["> 1%", "last 2 versions"]
      }
    }]
  ],
  "plugins": ["@babel/plugin-transform-runtime"]
}

相应的demo可以去github上找：点击我

编译typeScript

typescript-loader

安装相应的依赖

npm i typescript ts-loader --save-dev // 官方的
npm i typescript awesome-typescript-loader --save-dev // 社区的

由于版本冲突问题，建议直接使用github中的package.json中的版本确保可以编译成功

需要配置tsconfig.json

{
  "compilerOptions": {
    "module": "commonjs", // 指定生成哪个模块系统代码
    "target": "es5", // 指定ECMAScript目标版本
    "allowJs": true // 允许编译javascript文件
  },
  "include": [
    "./src/*" // 要编译的路径
  ],
  "exclude": [
    "./node_modules" // 不编译的路径
  ]
}

tsconfig所有配置列表：tsconfig配置表

app.ts

const NUM = 45;

interface Cat {
    name: string,
    age: number
}

function cat(cat: Cat) {
    console.log('cat',cat.name);
}

cat({
    name: 'jack',
    age:17
});

webpack.config.js

module.exports = {
    entry: {
        'app': './app.ts'
    },

    output: {
        filename: '[name].bundle.js'
    },

    module: {
        rules: [
            {
                test: /\.tsx?$/,
                use: {
                    loader: 'ts-loader'
                }
            }
        ]
    }
}

然后运行webpack看下打包后的内容