首页 > > 网页制作 > Javascript >

webpack4.x配置详情

2018-09-01 05:49:50来源：博客园阅读 ()

webpack打包工具现在非常流行，熟悉并且能够进行配置也变得非常重要。在学习和使用的过程中遇到过很多的问题，希望能够让自己记录下来，巩固自己的学习。

1.创建文件目录

先在自己的常用盘中（我自己的项目一般都建在E盘的一个文件夹下）创建一个文件夹，比如webpack_demo，我用的编辑器是visual studio code，使用ctrl+`直接切到这个文件目录下

然后在该终端输入npm init 使其生成一个package.json文件

然后在webpack_demo文件夹下建立如下文件目录：

2.进行基础配置打包

建立好上面的目录之后，现在就该往里面添加内容了。往index.html 、index.js里面添加一些内容，这些内容就看个人随意了，只要是合理的都可以。在这两个文件里面添加内容是为了待会进行webpack打包的时候，不至于让打包出来的东西都是空的，不然这就很尴尬了。然后就该进行webpack.config.js里面配置了。下面是我进行的简单的配置：

最为简单的入口、出口、插件、本地服务的配置。entry是入口文件，使用的是相对路径，对应到入口文件index.js，这里配置的是单入口文件。多入口的以后配置。output是打包后的文件的路径，使用的是绝对路径。打包后的文件都在dist目录下。出口文件的名称filename使用的是[name].js，这种写法就是为了与入口的文件名称相对应，也有另一个原因，就是多入口文件的时候，出口也相应的有多个，这样使用[name].js就不怕你是单入口还是多入口，很方便。接下来就是本地服务的配置，host可以使用本机ip地址，也可以使用localhost，port就是自己设置的端口。这个html-webpack-plugin插件有两个作用：

为html文件中引入的外部资源如script、link动态添加每次compile后的hash，防止引用缓存的外部文件问题
可以生成创建html入口文件，比如单页面可以生成一个html文件入口，配置N个html-webpack-plugin可以生成N个页面入口

这个插件有很多的配置项，这里我只用到了三个，removeAttributeQuotes是否去掉属性的引号，如下type 和 src属性里面的引号就都去掉了；hash 是否为所有注入的静态资源添加webpack每次编译产生的唯一hash值，添加hash形式如下所示

<script type=text/javascript src=index.js?772a5c2dd58541f56576></script></body>

template就是本地模板的设置。上述打包之后的结构目录如下

打包后的index.html文件里面的内容如下：

<!DOCTYPE html>
<html lang=en>
<head>
    <meta charset=UTF-8>
    <meta name=viewport content="width=device-width,initial-scale=1">
    <meta http-equiv=X-UA-Compatible content="ie=edge">
    <title>webpack_demo</title>
</head>
<body>
    <div id=title></div>
  <script type=text/javascript src=index.js?772a5c2dd58541f56576></script></body>
</html>

这就是一个最为简单的webpack打包使用了。

3.css样式与js分离

接下来就是往里面添砖加瓦了，有了js和html文件，当然还是需要有css文件了。在src目录下创建一个css文件夹，如下图：

在入口文件index.js里面引入index.css

import './css/index.css'
document.getElementById('title').innerHTML = 'webpack demo'

对css文件进行打包，需要安装一些依赖，style-loader、css-loader。

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

然后在webpack.config.js中加入module配置：

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

这里的use有几种配置方法，你也可以根据自己的喜好写，比如 use:['style-loader','css-loader']

然后进行打包，这个时候css打包在index.js文件中，如果要把css文件从js文件中分离出来，这个时候就需要用到mini-css-extract-plugin,这个插件需要webpack版本在4.4.0以上,以前是extract-text-webpack-plugin这个插件。

npm install --save-dev mini-css-extract-plugin

相关配置如下：

然后在进行打包，在dist文件夹下生成了css文件，内容如下:

至此css与js分离操作成功！

有不少的小伙伴肯定也有用less、sass、stylus这三种css预处理语言，在这里我也拿其中的一种stylus来做一个配置。顺便使用postcss + autoprefixer为 CSS 中的属性添加浏览器特定的前缀。先介绍一下postcss：PostCSS 本身是一个功能比较单一的工具。它提供了一种方式用 JavaScript 代码来处理 CSS。它负责把 CSS 代码解析成抽象语法树结构（Abstract Syntax Tree，AST），再交由插件来进行处理。PostCSS最为常用的插件是Autoprefixer，其作用是为 CSS 中的属性添加浏览器特定的前缀。Autoprefixer 可以根据需要指定支持的浏览器类型和版本，自动添加所需的带前缀的属性声明。开发人员在编写 CSS 时只需要使用 CSS 规范中的标准属性名即可。

首先安装依赖：

npm install --save-dev stylus stylus-loader

接着安装postcss依赖：

npm install --save-dev postcss postcss-loader autoprefixer

安装好这些依赖之后，就在目录下建立以下文件，如图：

文件里面的内容如下：

box.styl内容：

.box {
    display flex
    width 400px
    height 400px
    border 1px solid #000000
    transform rotate(45deg)
    p{
        color red
        font-size 14px
    }
}

postcss.config.js:

module.exports = {
    plugins: [
        require('autoprefixer')
    ]
}

做好以上准备之后，该在webpack.config.js文件里面进行stylus解析配置了：

module: {
        rules: [
            {
                test: /\.css$/,
                use: [
                    {loader: MiniCssExtractPlugin.loader},
                    'css-loader'
                ]
            },{
                test: /\.styl$/,
                use: [
                    {loader: MiniCssExtractPlugin.loader},
                    'css-loader',
                    'postcss-loader',
                    'stylus-loader'
                ]
            }
        ]
    }
//在此说明一下：因为是要对stylus文件里面的样式添加浏览器特定的前缀，所以需要在这里面引入postcss-loader进行解析，而且这几种loader的配置顺序不能颠倒，不然会产生错误或者达不到目的。我自己就尝试了把postcss-loader放在最后，解析就会出错。也算是一种小坑。

然后进行webpack打包，生成了如下：

此时你也会发现，不管是stylus文件还是.css文件，都会打包到一起，生成一个文件。

4、图片打包。

在src目录下创建文件夹images，并且添加一张图片，首先以背景图片的方式引入图片

然后安装依赖

npm install --save-dev file-loader url-loader

然后在module里面这样配置：

　　　　　　　{
              test: /\.(png|jpg|gif)/,
                use: [
                    {
                        loader: 'url-loader',
                        options: {
                            limit: 5000,//如果小于则以base64位显示，大于这个则以图片路径显示
                            outputPath: 'images/'//让图片都打包到images文件夹下
                        }
                    }
                ]
            }

这时候打包出来后，在dist下会出现一个images文件夹：

这时候打包是成功了，但是开启本地服务之后，发现图片的路径有问题。这里面就是有个坑。这个时候就需要解决静态资源的路劲问题。如下：

webpack.config.js

let website = {
    publicPath: 'http://192.168.27.21:8080/'//这个就是本地监听服务
}

output: {
        path: path.resolve(__dirname,'dist'),
        filename: '[name].js',
        publicPath: website.publicPath//解决静态路径的问题，比如图片的路径
    },

图片在html中还有另一种写法

<body>
    <div id="title"></div>
    <div class="box">
        <p>这里是box里面的内容</p>
    </div>
    <div class="wrap"></div>
    <img src="./images/none.png" />
</body>

如果需要对里面的图片打包到images/文件夹下，就需要使用一个插件html-withimg-loader

npm install --save-dev html-withimg-loader

{
          test: /\.(htm|html)$/i,
          use: ['html-withimg-loader']//这个插件是让html里面的图片打包到images/文件夹下
 }

打包后生成的内容是：

<body>
    <div id=title></div>
    <div class=box>
        <p>这里是box里面的内容</p>
    </div>
    <!-- <div class="wrap"></div> -->
    <img src=http://192.168.27.21:8080/images/3ae16dcddacdf7d99b869750401202fb.png>
<script type=text/javascript src=http://192.168.27.21:8080/index.js?2735cd9759ec100ecd6f></script></body>

5、es6语法转化babel配置

现在babel-loader的版本都8.0.0了，其他依赖配置都发生了一些改变，由以前版本的bebel-core 、babel-preset-env、babel-preset-react、babel-preset-es2015到现在的 @babel/core、@babel/preset-env、@babel/preset-es2015、@babel/preset-react

npm install --save-dev babel-loader 
npm install --save-dev @babel/core  @babel/preset-env @babel/preset-react

//webpack.config.js

           {
                test: /\.(jsx|js)$/,
                use: [
                    {
                        loader: 'babel-loader',
                    }
                ],
                exclude: /node_modules/
            }

//创建.babelrc文件

{
    "presets": [
        "@babel/preset-env",
        "@babel/preset-react"
    ]
}

这样就可以了。打包之后就可以看到效果。

6、环境配置

package.json

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "server": "webpack-dev-server",
    "dev": "set type=dev&webpack",
    "build": "set type=pro&webpack"
  },

webpack.config.js
if(process.env.type=="dev"){//本地环境
    var website = {
        publicPath: 'http://192.168.27.21:8080/'
    }
}else{
    var website = {
        publicPath: 'http://*****' //你的线上地址
    }
}