webpack入门

785 阅读17分钟

写在前面的话

前几年入门webpack是在segmentFault上看到的一篇很好的文章,链接在这里,有兴趣的同学可以去看看,不过现在到4.x的版本了,好多东西不适用,就想自己再总结一下,同样,如果你对webpack很多基础的东西都很明白的话,这篇文章可能对你没有什么价值,如果你对webpack的一些概念还是很模糊,相信跟着这篇文章敲下来应该会有更清晰的认识。

什么是webpack

官网的定义是:

本质上,webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle

通俗的点来说,webpack就是一个打包器,将你的项目视为一个整体,通过给定的一个或多个入口,找到项目中所有的依赖文件,使用loaders来处理他们,把你项目里的代码(.ts, .scss .less .jsx等文件)打包翻译成浏览器可以识别的代码,这样我们只需要专注于开发就可以了。

webpack的使用

初步了解webpack后,我们下面开始使用webpack

安装webpack

webpack的安装有两种方式:1. 全局安装   2. 非全局安装

新建一个空的文件夹:webpack_project, 进入到该目录下后

npm init -y // 生成package.json文件
npm install -g webpack  // 全局安装webpack
npm install -D webpack  // 安装在项目目录webpack
npm install -g webpack-cli  // 全局安装webpack命令行

我在这里选择的是安装在项目目录中 然后在webpack_project下新建一个srcpublic的文件夹,src文件夹用来存放我们要写的代码模块,public文件夹用来存放webpack打包之后供浏览器读取的文件,分别在创建三个文件

  • index.html    // 放在public下
  • Greeter.js   // 放在src下
  • main.js    // 放在src下

目录结构如下

我们在index.html文件中写入最基础的html代码:

<html lang="en">
    <head>
        <meta charset="utf-8">
        <title>webpack_project</title>
    </head>
    <body>
        <div id='root'></div>
        <script src="bundle.js"></script>
    </body>
</html>

在Greeter中暴露出一个返回div的dom元素的函数

// Greeter.js
module.exports = function() {
  const greet = document.createElement('div');
  greet.textContent = "Hello webpack!";
  return greet;
};

main.js文件中我们将Greeter模块返回的节点插入页面

//main.js 
const greeter = require('./Greeter.js');
document.querySelector("#root").appendChild(greeter());

正式使用webpack

调出终端在当前项目目录下:

webpack {enterFile} -o {outputFile}   // enterFile 要打包的文件  outputFile打包后的文件

对于本例来说就是:

webpack src/main.js -o public/bundle.js  

会看到如下结果:

可以看到webpack打包了main.js和Greeter.js文件,运行public下的index.html

浏览器已经成功运行了打包后的代码!!

通过配置使用webpack

webpack还有很多其他的功能,但是这些功能如果都通过命令行来实现很不方便,也极容易出错,一个好的解决办法就是使用配置文件,乍一听配置文件大家可能比较方,其实就是一个Js的模块,把打包信息放在模块里而已

继续上一个例子来说明如何书写这个配置文件,在根目录下新建一个名为webpack.config.js的文件,放一些很简单的配置信息,包括入口文件路径和打包后文件的存放路径

module.exports = {
  entry:  __dirname + "/src/main.js",  //入口文件
  output: {
    path: __dirname + "/public",  //存放打包后的文件路径
    filename: "bundle.js" //打包后的文件名
  }
}

有了这个文件,下次在打包的时候只需要在终端中输入webpack即可完成打包了,也许你会觉得在终端中输入webpack会很奇怪也不直观,可以在package.json的script中像我这样添加一个命令行 可在终端中直接输入

npm run start

构建本地服务器

webpack提供了一个可选的本地开发服务器,可以监听你的本地代码修改,并自动刷新修改后的结果,这个本地服务器基于node.js构建,不过它是一个单独的组件,在webpack中进行配置之前需要单独安装它作为项目依赖

npm install --save-dev webpack-dev-server

devserver作为webpack配置选项中的一项,以下是它的一些配置选项,更多配置可参考这里

devserver的配置选项功能描述
contentBase默认webpack-dev-server会为根文件夹提供本地服务器,如果想为另外一个目录下的文件提供本地服务器,应该在这里设置其所在目录(本例设置到“public"目录)
port设置默认监听端口,如果省略,默认为”8080“
inline设置为 true,当源文件改变时会自动刷新页面
historyApiFallback在开发单页应用时非常有用,它依赖于HTML5 history API,如果设置为true,所有的跳转将指向index.html

把这些配置项添加到webpack配置文件中去,现在的配置文件webpack.config.js

module.exports = {
    entry:  __dirname + "/src/main.js",  //入口文件
    output: {
        path: __dirname + "/public",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    }
}

在package.json中的scripts对象中添加如下命令,用以开启本地服务器:

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "webpack",
    "server": "webpack-dev-server --open"
  },

在终端中输入:

npm run server

即可在本地的8080端口查看结果

Loaders

Loaders可以说是webpack强大的核心功能之一了,它提供了调用外部脚本的能力,实现对不同格式的代码进行编译处理,处理成浏览器可以识别的JS,CSS等。比如ts-loader可以将我们编写的.ts文件编译打包成.js文件,less-loader可以将.less文件预编译成.css文件,"react-loader"可以将.jsx编译成.js文件等等,下面介绍一些常用的loader。

Loaders需要单独安装并且需要在webpack.config.js中的modules关键字下进行配置,Loaders的配置包括以下几方面:

  • test 用来匹配loaders所处理文件的拓展名的正则表达式(必须),告诉某个loader处理匹配上的哪些文件
  • loader 指定匹配上的文件用什么loader来处理他们(必须)
  • include/exclude 手动添加必须处理的文件(文件夹)或屏蔽不需要处理的文件(文件夹)(可选);
  • query:为loaders提供额外的设置选项(可选)

不过在配置loader之前,我们把Greeter.js里的问候消息放在一个单独的JSON文件里,并通过合适的配置使Greeter.js可以读取该JSON文件的值,各文件修改后的代码如下:

在src文件夹中创建带有问候信息的JSON文件(命名为config.json)

{
  "greetText": "Hi there and greetings from JSON!"
}

更新后的Greeter.js

const config = require('./config.json');
module.exports = function() {
    const greet = document.createElement('div');
    greet.textContent = config.greetText;
    return greet;
};

babel

Babel其实是一个编译JavaScript的平台,它可以编译代码帮你达到以下目的:

  • 让你能使用最新的JavaScript代码(ES6,ES7...),而不用管新标准是否被当前使用的浏览器完全支持;
  • 让你能使用基于JavaScript进行了拓展的语言,比如React的JSX;

Babel的安装与配置

Babel其实是几个模块化的包,其核心功能位于称为babel-core的npm包中,webpack可以把其不同的包整合在一起使用,对于每一个你需要的功能或拓展,你都需要安装单独的包(用得最多的是解析Es6的babel-env-preset包和解析JSX的babel-preset-react包)。

我们先来一次性安装这些依赖包

// npm一次性安装多个依赖模块,模块之间用空格隔开
npm install --save-dev babel-core babel-loader babel-preset-env babel-preset-react

在webpack的配置文件中配置babel:

module.exports = {
    entry:  __dirname + "/src/main.js",  //入口文件
    output: {
        path: __dirname + "/public",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    options: {
                        presets: [
                            "env", "react"
                        ]
                    }
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            }
        ]
    }
}

现在你的webpack的配置已经允许你使用ES6以及JSX的语法了。继续用上面的例子进行测试,不过这次我们会使用React,记得先安装 React 和 React-DOM

npm install --save react react-dom

接下来我们使用ES6的语法,更新Greeter.js并返回一个React组件

报错:Error: Cannot find module '@babel/core' babel-loader@8 requires Babel 7.x (the package '@babel/core'). If you'd like to use Babel 6.x ('babel-core'), you should install 'babel-loader@7'

因为babel-loader的版本问题 先卸载 npm uninstall babel-loader 重装一个@7的版本 npm i babel-loader@7 -D

重新使用npm start打包,如果之前打开的本地服务器没有关闭,你应该可以在localhost:8080下看到与之前一样的内容,这说明react和es6被正常打包了。

babel的配置

Babel其实可以完全在 webpack.config.js 中进行配置,但是考虑到babel具有非常多的配置选项,在单一的webpack.config.js文件中进行配置往往使得这个文件显得太复杂,因此一些开发者支持把babel的配置选项放在一个单独的名为 ".babelrc" 的配置文件中。我们现在的babel的配置并不算复杂,不过之后我们会再加一些东西,因此现在我们就提取出相关部分,分两个配置文件进行配置(webpack会自动调用.babelrc里的babel配置选项),如下:

// webpack.config.js
module.exports = {
    entry:  __dirname + "/src/main.jsx",  //入口文件
    output: {
        path: __dirname + "/public",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            }
        ]
    }
}
// .babelrc
{
  "presets": ["react", "env"]
}

到目前为止,我们已经知道了,对于模块,Webpack能提供非常强大的处理功能,那那些是模块呢。

一切皆模块

Webpack有一个不可不说的优点,它把所有的文件都都当做模块处理,JavaScript代码,CSS和fonts以及图片等等通过合适的loader都可以被处理。

CSS

webpack提供两个工具处理样式表,css-loader 和 style-loader,二者处理的任务不同,css-loader使你能够使用类似@import 和 url(...)的方法实现 require()的功能,style-loader将所有的计算后的样式加入页面中,二者组合在一起使你能够把样式表嵌入webpack打包后的JS文件中。

继续上面的例子

// 安装
npm install --save-dev style-loader css-loader

配置更新如下,添加css-loader,style-loader:

module.exports = {
    ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader"
                    }
                ]
            }
        ]
    }
};

接下来,在src文件夹里创建一个名字为"main.css"的文件,对一些元素设置样式

/* main.css */
html {
    box-sizing: border-box;
    -ms-text-size-adjust: 100%;
    -webkit-text-size-adjust: 100%;
}

*, *:before, *:after {
    box-sizing: inherit;
}

body {
    margin: 0;
    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
}

h1, h2, h3, h4, h5, h6, p, ul {
    margin: 0;
    padding: 0;
}

我们这里例子中用到的webpack只有单一的入口,其它的模块需要通过 import, require, url等与入口文件建立其关联,为了让webpack能找到”main.css“文件,我们把它导入”main.js “中,这样webpack就能找到main.css了,如下

//main.js
import React from 'react';
import {render} from 'react-dom';
import Greeter from './Greeter';

import './main.css';//使用require导入css文件

render(<Greeter />, document.getElementById('root'));

上面的代码说明webpack是怎么把css当做模块看待的,咱们继续看一个更加真实的css模块实践

css Module

JavaScript通过一些新的语言特性,更好的工具以及更好的实践方法(比如说模块化)发展得非常迅速。模块使得开发者把复杂的代码转化为小的,干净的,依赖声明明确的单元,配合优化工具,依赖管理和加载管理可以自动完成。

不过前端的另外一部分,CSS发展就相对慢一些,大多的样式表却依旧巨大且充满了全局类名,维护和修改都非常困难。

被称为CSS modules的技术意在把JS的模块化思想带入CSS中来,通过CSS模块,所有的类名,动画名默认都只作用于当前模块。Webpack对CSS模块化提供了非常好的支持,只需要在CSS loader中进行简单配置即可,然后就可以直接把CSS的类名传递到组件的代码中,这样做有效避免了全局污染。具体的代码如下

module.exports = {
    ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    }
                ]
            }
        ]
    }
};

我们在app文件夹下创建一个Greeter.css文件来进行一下测试

/* Greeter.css */
.root {
  background-color: #eee;
  padding: 10px;
  border: 3px solid #ccc;
}

导入.root到Greeter.js中

import React, {Component} from 'react';
import config from './config.json';
import styles from './Greeter.css';//导入

class Greeter extends Component{
  render() {
    return (
      <div className={styles.root}> //使用cssModule添加类名的方法
        {config.greetText}
      </div>
    );
  }
}

export default Greeter

结果相同的类名也不会造成不同组件之间的污染。

CSS预处理器

Sass 和 Less 之类的预处理器是对原生CSS的拓展,它们允许你使用类似于variables, nesting, mixins, inheritance等不存在于CSS中的特性来写CSS,CSS预处理器可以这些特殊类型的语句转化为浏览器可识别的CSS语句,

你现在可能都已经熟悉了,在webpack里使用相关loaders进行配置就可以使用了,以下是常用的CSS 处理loaders:

  • Less Loader
  • Sass Loader
  • Stylus Loader

不过其实也存在一个CSS的处理平台-PostCSS,它可以帮助你的CSS实现更多的功能,查看这里可以了解更多 举例来说如何使用PostCSS,我们使用PostCSS来为CSS代码自动添加适应不同浏览器的CSS前缀。

首先安装postcss-loader 和 autoprefixer(自动添加前缀的插件)

npm install --save-dev postcss-loader autoprefixer

接下来,在webpack配置文件中添加postcss-loader,在根目录新建postcss.config.js,并添加如下代码之后,重新使用npm start打包时,你写的css会自动根据Can i use里的数据添加不同前缀了。

module.exports = {
   ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    },
                    {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    }
};

至此,本文已经谈论了处理JS的Babel和处理CSS的PostCSS的基本用法,它们其实也是两个单独的平台,配合webpack可以很好的发挥它们的作用。接下来介绍Webpack中另一个非常重要的功能-Plugins

插件

插件(Plugins)是用来拓展Webpack功能的,它们会在整个构建过程中生效,执行相关的任务。 Loaders和Plugins常常被弄混,但是他们其实是完全不同的东西,可以这么来说,loaders是在打包构建过程中用来处理源文件的(JSX,Scss,Less..),一次处理一个,插件并不直接操作单个文件,它直接对整个构建过程其作用。

Webpack有很多内置插件,同时也有很多第三方插件,可以让我们完成更加丰富的功能。

使用插件的方法

要使用某个插件,我们需要通过npm安装它,然后要做的就是在webpack配置中的plugins关键字部分添加该插件的一个实例(plugins是一个数组)继续上面的例子,我们添加了一个给打包后代码添加版权声明的插件。

const webpack = require('webpack');

module.exports = {
    ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    },
                    {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版权所有,翻版必究')
    ],
};

通过这个插件,打包后的JS文件头就会有如下效果: 这就是webpack插件的基础用法了,下面给大家推荐几个常用的插件

HtmlWebpackPlugin

这个插件的作用是依据一个简单的index.html模板,生成一个自动引用你打包后的JS文件的新index.html。这在每次生成的js文件名称不同时非常有用(比如添加了hash值)。 安装:

npm install --save-dev html-webpack-plugin

这个插件自动完成了我们之前手动做的一些事情,在正式使用之前需要对一直以来的项目结构做一些更改:

  • 移除public文件夹,利用此插件,index.html文件会自动生成,此外CSS已经通过前面的操作打包到JS中了。
  • 在src目录下,创建一个index.tmpl.html文件模板,这个模板包含title等必须元素,在编译过程中,插件会依据此模板生成最终的html页面,会自动添加所依赖的 css, js,favicon等文件,index.tmpl.html中的模板源代码如下:
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Webpack Sample Project</title>
  </head>
  <body>
    <div id='root'>
    </div>
  </body>
</html>

更新webpack的配置文件,方法同上,新建一个build文件夹用来存放最终的输出文件

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry:  __dirname + "/src/main.jsx",  //入口文件
    output: {
        path: __dirname + "/build",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    },
                    {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版权所有,翻版必究'),
        new HtmlWebpackPlugin(({
            template: __dirname + "/src/index.tmpl.html" // new 一个这个插件的实例,并传入相关的参数
        }))
    ],
};

再次执行npm start你会发现,build文件夹下面生成了bundle.js和index.html。

Hot Module Replacement

Hot Module Replacement(HMR)也是webpack里很有用的一个插件,它允许你在修改组件代码后,自动刷新实时预览修改后的效果。

在webpack中实现HMR也很简单,只需要做两项配置:

  • 在webpack配置文件中添加HMR插件;
  • 在Webpack Dev Server中添加“hot”参数;

不过配置完这些后,JS模块其实还是不能自动热加载的,还需要在你的JS模块中执行一个Webpack提供的API才能实现热加载,虽然这个API不难使用,但是如果是React模块,使用我们已经熟悉的Babel可以更方便的实现功能热加载。

整理下我们的思路,具体实现方法如下:

  • Babel和webpack是独立的工具
  • 二者可以一起工作
  • 二者都可以通过插件拓展功能
  • HMR是一个webpack插件,它让你能浏览器中实时观察模块修改后的效果,但是如果你想让它工作,需要对模块进行额外的配额;
  • Babel有一个叫做react-transform-hrm的插件,可以在不对React模块进行额外的配置的前提下让HMR正常工作;

还是继续上例来实际看看如何配置

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry:  __dirname + "/src/main.jsx",  //入口文件
    output: {
        path: __dirname + "/build",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    },
                    {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版权所有,翻版必究'),
        new HtmlWebpackPlugin(({
            template: __dirname + "/src/index.tmpl.html" // new 一个这个插件的实例,并传入相关的参数
        })),
        new webpack.HotModuleReplacementPlugin()  // 热加载
    ],
};

安装react-transform-hmr

npm install --save-dev babel-plugin-react-transform react-transform-hmr

配置Babel

// .babelrc
{
  "presets": ["react", "env"],
  "env": {
    "development": {
    "plugins": [["react-transform", {
       "transforms": [{
         "transform": "react-transform-hmr",
         
         "imports": ["react"],
         
         "locals": ["module"]
       }]
     }]]
    }
  }
}

现在当你使用React时,可以热加载模块了,每次保存就能在浏览器上看到更新内容。

优化插件

webpack提供了一些在发布阶段非常有用的优化插件,它们大多来自于webpack社区,可以通过npm安装,通过以下插件可以完成产品发布阶段所需的功能

  • OccurenceOrderPlugin :为组件分配ID,通过这个插件webpack可以分析和优先考虑使用最多的模块,并为它们分配最小的ID
  • UglifyJsPlugin:压缩JS代码;
  • ExtractTextPlugin:分离CSS和JS文件

我们继续用例子来看看如何添加它们,OccurenceOrder 和 UglifyJS plugins 都是内置插件,你需要做的只是安装其它非内置插件

npm install --save-dev extract-text-webpack-plugin

然后再配置他们

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');


module.exports = {
    entry:  __dirname + "/src/main.jsx",  //入口文件
    output: {
        path: __dirname + "/build",  //存放打包后的文件路径
        filename: "bundle.js" //打包后的文件名
    },
    devServer: {
        contentBase: "./public",  // 本地服务器所加载的页面所在的目录
        historyApiFallback: true,  // 不跳转
        inline: true // 开启实时刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,  // 匹配以jsx或者js为结尾的文件
                use: {
                    loader: "babel-loader",  // 用babel-loader处理以上被匹配上的文件
                    // babel配置迁移到.babelrc下
                    /*
                        options: {
                            presets: [
                                "env", "react"
                            ]
                        }
                    */
                },
                exclude: /node_modules/   // 不包括node_modules里的文件
            },
            {
                test: /\.css$/,
                // 同一个文件类型使用多个loader用一个数组包裹即可
                use: [
                    {
                        loader: "style-loader"
                    },
                    {
                        loader: "css-loader",
                        options: {
                            modules: {
                                localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式
                            },
                        }
                    },
                    {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版权所有,翻版必究'),
        new HtmlWebpackPlugin(({
            template: __dirname + "/src/index.tmpl.html" // new 一个这个插件的实例,并传入相关的参数
        })),
        new webpack.HotModuleReplacementPlugin(),  // 热加载
        new ExtractTextPlugin("style.css"),
        new webpack.optimize.OccurrenceOrderPlugin(),
    ],
};

缓存

缓存无处不在,使用缓存的最好方法是保证你的文件名和文件内容是匹配的(内容改变,名称相应改变)

webpack可以把一个哈希值添加到打包的文件名中,使用方法如下,添加特殊的字符串混合体([name], [id] and [hash])到输出文件名前

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');

module.exports = {
..
    output: {
        path: __dirname + "/build",
        filename: "bundle-[hash].js"
    },
   ...
};

现在用户会有合理的缓存了。

去除build文件中的残余文件

引入clean-webpack-plugin插件后在配置文件的plugins中做相应配置即可:

安装:

npm install clean-webpack-plugin --save-dev

配置:

const {CleanWebpackPlugin} = require("clean-webpack-plugin");
  plugins: [
    ...// 这里是之前配置的其它各种插件
    new CleanWebpackPlugin()
  ]

关于clean-webpack-plugin的详细使用可参考这里

最后

这是一篇好长的文章,谢谢你的耐心,能仔细看到了这里