webpack配置

Posted

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了webpack配置相关的知识，希望对你有一定的参考价值。

参考技术A

一个打包工具

npm install --save-dev webpack : 安装Webpack
npm install webpack webpack-cli --save-dev :此工具用于在命令行中运行 webpack

webpack 开箱即用，可以无需使用任何配置文件。webpack 会假定项目的入口起点为 src/index.js ，然后会在 dist/main.js 输出结果，并且在生产环境开启压缩和优化。
在package.json文件中添加命令，然后通过npm run build即可运行打包

但是通常项目还需要继续扩展此能力，为此可以在项目根目录下创建一个 webpack.config.js 文件，然后 webpack 会自动使用它。

也可以根据特定情况使用不同的配置文件，则可以通过在命令行中使用 --config flag 修改此配置文件名称。

每个html页面都有一个入口点，单页面应用：一个入口起点；多页面应用：多个入口起点

mode?: "development" | "production" | "none";
。。。。。

（webpack 提供合理的默认值，但是还是可能会修改一些解析的细节）

条件的输入值由两种，

在条件中，对 resource 进行匹配的属性有 test / include / exclude / resource

在条件中，对 issuer 进行匹配的属性有 issuer

注：当使用多个条件属性时，需要同时满足，当属性条件为数组时，满足数据中的一个即可

可以对匹配规则的模块进行 应用loader 或者 解析选项对象

oneOf?: RuleSetRule[];
rules?: RuleSetRule[];

webpack配置示例：

webpack基础知识以及配置

webpack基础配置demo

文章目录

webpack基础知识以及配置

  • webpack：静态模块打包工具。webpack中的一切资源都是文件。
  • webpack是通过从入口进行递归查询的方式直接或者间接相互依赖的文件，最后生成打包文件。
  • webpack-cli处理打包命令，解析webpack命令。webpack包做文件打包工作
  • webpack不用全局下载，只用局部下载即可。因为不同项目可能使用的webpack版本不一样
  • webpack本身能解析打包各种模块规范的js代码

webpack

yarn init -y

yarn add -D webpack webpack-cli

//创建src/index.js因为webpack打包默认会找src目录下面的index.js文件
//此时执行webpack命令，可以看到webpack将其打了个基础包，在dist目录下

//package.json中配置打包命令，之后使用npm run build进行webpack打包
  "scripts": {
    "build":"webpack"
  },

  • 创建webpack.config.js文件，写入相关配置

  • clean-webpack-plugin@1.0.1上一次打包的文件清除

  • html-webpack-plugin解决手动引入

  • webpack-dev-server解决自动打包不需要手动打包

yarn add -D webpack-dev-server	html-webpack-plugin		clean-webpack-plugin@1.0.1 

cnpm install @babel/core @babel/plugin-transform-runtime @babel/polyfill @babel/preset-env @babel/runtime autoprefixer babel-eslint babel-loader copy-webpack-plugin css-loader eslint eslint-friendly-formatter eslint-loader file-loader html-webpack-plugin --save-dev

webpack常用10个配置

  • mode模式：不同模式为我们加载不同的配置

    • none
    • development
    • production

  • 入口entry：可以有一个或者多个，单页打包或者多页打包

  • 出口output：指定打包文件夹

  • modules模块加载器，用于指定loader：webpack本身只能打包js不能处理css、图片等资源。因此就需要模块加载器将css、图片等资源进行打包或者地址引用的处理

  • plugins插件：需要打包js之外做的事情，比如：压缩、拷贝、清除、引入页面等操作。插件名称一般是xx-webpack-plugin的形式

    • Clean-webpack-plugin清除插件
    • Html-webpack-plugin

  • devtools开发工具

  • devServer开发服务器配置。比如说：配置代理，以及不带#理由（react的Broswer路由）的404问题

  • resolve解析别名以及路径

  • optimization指定优化处理的。比如css的压缩优化（optimize-css-assets-webpack-plugin）

  • externals外部某个包，配置某个包，比如说使用了lodash不用npm，在这里配置使用也是可以的

webpack常用包

  • webpack-dev-server开发服务器的包
  • Web pack-merge合并包
  • cross-env
  • css-loader
  • style-loader
  • postcss-loader
    • autoprefixer自动浏览器适配，适配浏览器
    • postcss-px2em写的px自动转化成rem适配移动端
  • less-loader
  • styles-loader
  • sass-loader
  • file-loader
  • url-loader
  • image-webpack-loader压缩图片的包，不影响显示效果
  • babel-loader
    • @babel/core
    • @babel/preset-env
    • @babel/preset-react
    • @babel/polyfill
    • @babel/plugin-transform-runtime
    • @babel/runtime
  • Vue-loader
  • eslint-loader
  • thread-loader多线程打包
  • html-webpack-plugin把打包的c s s或者js自动引入到界面中去
  • clean-webpack-plugin删除文件。一般用于清除上一次打包文件
  • mini-css-extract-plugin单独提取打包css
  • optimize-css-assets-webpack-plugin压缩css
  • copy-webpack-plugin拷贝文件
  • terser-webpack-plugin压缩js
  • add-asset-html-webpack-plugin
  • webpack-bundle-analyzer分析打包文件
  • webpack.ProgressPlugin显示打包进度
  • webpack.HotModuleReplacementPlugin热加载替换
  • webpack.HashedModulesPlugin模块id哈希
  • webpack.DLLPlugin多进程打包
  • Web pack.DLLReferencePlugin多进程打包
  • new webpack.ProvidePlugin

babel

babel本身是不能进行ES6转ES5的，它提供了一个平台babel-core靠babel-core去组织每一个语法对应的插件去进行解析

  • babel相关的包
    • babel-loader
    • @babel/core
    • @babel/preset-env预设包，很多插件包的集合包
    • @babel/polyfill补丁包处理不兼容的语法
    • @babel/plugin-transform-runtime & @babel/runtime

打包图片

  • file-loader
  • url-loader：处理图片主要是用这个，但是它是需要file-loader做基础。并且不仅图片、音视频、字体文件、打包样式、格式处理都可以使用这个文件

配置babel的加载模块

webpack本身不会处理ES6语法，需要babel进行处理

babel-loader配置文档链接

babel的babel.config.js文件配置

module.exports = function (api) {
    api.cache(true);        //做缓存处理加载打包
  
    const presets = [               //预设的数组;可以直接写一个数组，里面是包的名称字符串；如果这个包有一些其他的配置项的话，那么每一个配置也用一个数组表示，这个数组的第一位就是包名称，第二位是一个{},里面写相关配置选项
       [ 
           '@babel/preset-env',         //预设配置的包名
            {                           //预设配置的配置
                "useBuiltIns":'usage',     //有三个只：false、usage、entry。默认值false，polyfill全部引入打包;usage用到什么打包什么;entry根据配置的浏览器目标来进行打包。只打包引入浏览器没有实现的
                "corejs":2,                 //corejs版本
                "targets":{
                    "ie":10,
                    "chrome":67
                }
            }                          
        ],
    ];            
    const plugins = [               //插件的数组
        "@babel/plugin-transform-runtime"

    ];            
    return {
      presets,
      plugins
    };
  }

配置样式打包加载模块

  • 基本css
  • css预编译器
    • less
    • sass
    • stylus

  • postcss

  • 抽取/单独打包css
  • 压缩css
css预编译器
cnpm install style-loader css css-loader less less-loader node-sass sass-loader stylus stylus-loader  --save
PostCss

postcss官网

  • postcss.config.js
module.exports = {
    plugins: [
    //   require('precss'),
      require('autoprefixer')()
    ]
 }
  • config.webpack.js中postcss配置
    //模块加载器
    module:{
        rules:[
            //处理css
            {
                test: /\\.css$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',                //css-loader将css内容打包到js中去
                    'postcss-loader',           //预处理css的，要在css前进行，因此由于loader加载顺序，放在css-loader的下面或者右边

                ]                                                
                
            },
            
            
            //处理less
            {
                test: /\\.less$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',               //css-loader将css内容打包到js中去
                    'postcss-loader',
                    'less-loader',
                ]                                                
                
            },
            
            
            //处理stylus
            {
                test: /\\.(styl|stylus)$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',               //css-loader将css内容打包到js中去
                    'postcss-loader',
                    'stylus-loader'
                ]                                                
                
            }
        ]
    },
样式单独打包
  • mini-css-extract-plugin
npm install --save-dev mini-css-extract-plugin

webpack中配置

const MiniCssExtracPlugin = require('mini-css-extract-plugin')


//webpack中配置
plugins:[
    //从js中抽取css单独打包;一旦抽取了css就不需要cssloader了，需要换成这个插件里面的loader。单独打包css
    new MiniCssExtracPlugin({
        filename:'css/[name].css'
    })
]
  

//webpack中loader配置。使用MiniCssExtracPlugin.loader代替style-loader即可
{
    test: /\\.css$/,                                    //指定对哪些文件进行处理，正则
    exclude: /(node_modules|bower_components)/,         //不包括哪些文件
    include:resolve('src'),                                         //包括哪些文件
    use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
        MiniCssExtracPlugin.loader,         //代替style-loader
        // 'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
        'css-loader',                //css-loader将css内容打包到js中去
        'postcss-loader',           //预处理css的，要在css前进行，因此由于loader加载顺序，放在css-loader的下面或者右边

    ]                                                

}
css样式压缩
npm install --save-dev optimize-css-assets-webpack-plugin
  • webpack配置
const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');

//优化配置
  optimization:{
      minimizer:[new OptimizeCssAssetsPlugin()]
  }
eslint

//webpack中配置
module:{
    rules:[
        {
            enforce:'pre',          //前置loader最先执行;pre:最先执行；post:最后执行
            test: /\\.m?js$/,        
            include:resolve('src'), 
            loader:'eslint-loader',  
            options:{
                formatter:'eslint-friendly-formatter'       //友好格式化
            }
        },
    ]
}

//配置好之后，初始化配置文件，执行下面方法生成配置文件.eslintrc.js
npx eslint --init 


//.eslintrc.js中进行相关配置
module.exports = {
    "env": {
        "browser": true,
        "es2021": true,
        "node":true
    },
    // "extends": "eslint:rall",        开启所有的规则检查
    "extends": "eslint:recommended",        //只开启推荐的规则检查
    "globals":{         //定义全局变量；也就是这个变量及时不进行定义，全局也可以使用
        "SharedArrayBuffer":"readonly"
    },
    "parserOptions": {
        "ecmaVersion": 12,
        "sourceType": "module"
    },
    "rules": {
        "no-unused-vars":"off"          //不去检查未定义变量使用的情况
    }
};
webpack基础配置
/**
 * webpack配置要向外暴露一个对象，用commonjs的规范进行，因为webpack内部是基于node来进行的处理
 */

const path = require('path'); 
const HtmlWebpackPlugin = require('html-webpack-plugin')
const CleanWebpackPlugin = require('clean-webpack-plugin')
const MiniCssExtracPlugin = require('mini-css-extract-plugin')
const webpack = require('webpack');
const { optimize } = require('webpack');
const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');




function resolve(dir){          //传入一个目录名称，就返回当前目录名称所在的绝对路径

    return path.resolve(__dirname,dir)
}

module.exports = {
    //模式
    mode:'production',
    //入口:入口可以是字符串、对象、数组，都是可以的 
    entry:{
        main:resolve('src/index.js')
    },
    //出口
    output:{
        path:resolve('dist'),
        filename:'bundle.js',
        publicPath:'/'          //解决图片路径问题；所有生成的URL链接左侧用/开头；即相对路径
    },
    //模块加载器；按照顺序从下往上执行。enfore可以改变这个顺序
    module:{
        rules:[
            {
                enforce:'pre',          //前置loader最先执行;pre:最先执行；post:最后执行
                test: /\\.m?js$/,        
                include:resolve('src'), 
                loader:'eslint-loader',  
                options:{
                    formatter:'eslint-friendly-formatter'       //友好格式化
                }
            },
            //处理ES6到ES5
            {
                test: /\\.m?js$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    {                                              
                        loader: 'babel-loader',                     //babel也可以专门用配置文件babel.config.js或者.babelrc进行配置，也可以这两个配置文件都不屑直接在wbpack的这个地方进行配置即可
                        // options: {
                        //     presets: ['@babel/preset-env']       //这边的配置也可以在babel.config.js中写
                        // }
                    }
                ]                                                
                
            },{
                //处理图片
                test: /\\.(jpe?g|png|webp|gif)$/,                                    //指定对哪些文件进行处理，正则
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    {                                              
                        loader: 'url-loader',                     //babel也可以专门用配置文件babel.config.js或者.babelrc进行配置，也可以这两个配置文件都不屑直接在wbpack的这个地方进行配置即可。处理图片、字体、音视频等
                        options: {
                            limit: 1024*15,                         //把小于15kb的进行base64处理
                            name:'img/[name].[ext]'                 //文件路径；相对于所有文件下面的；[name]文件名[ext]后缀扩展名
                        }
                    }
                ]      
            }, 
            //处理css
            {
                test: /\\.css$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    MiniCssExtracPlugin.loader,         //代替style-loader
                    // 'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',                //css-loader将css内容打包到js中去
                    'postcss-loader',           //预处理css的，要在css前进行，因此由于loader加载顺序，放在css-loader的下面或者右边

                ]                                                
                
            },
            //处理less
            {
                test: /\\.less$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    MiniCssExtracPlugin.loader,         //代替style-loader
                    // 'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',               //css-loader将css内容打包到js中去
                    'postcss-loader',
                    'less-loader',
                ]                                                
                
            },
            //处理stylus
            {
                test: /\\.(styl|stylus)$/,                                    //指定对哪些文件进行处理，正则
                exclude: /(node_modules|bower_components)/,         //不包括哪些文件
                include:resolve('src'),                                         //包括哪些文件
                use:[                                               //使用；可以使用对象、数组；写对象只有 一个loader，并且loader还有配置以及指定一些额外信息；对象是数组的简写，数组中可以有任意多的loader，但是数组这种方式不可以写配置
                    MiniCssExtracPlugin.loader,
                    // 'style-loader',             //style-loader将js中的css放到style标签中去      配置多个loader整体的顺序是从下往上，从右往左。所以应该是css-loader放在style-loader的下面
                    'css-loader',               //css-loader将css内容打包到js中去
                    'postcss-loader',
                    'stylus-loader'
                ]                                                
                
            }
        ]
    },
    //插件
    plugins:[
        //向页面中引入打包的js或者css代码
        new HtmlWebpackPlugin({
            template:'public/index.html'           //指定以哪个为模板
        }),

        //清除打包文件夹
        new CleanWebpackPlugin(['dist']),
        // new webpack.ProvidePlugin({
        //     jQuery: "jquery",           //配置jquery
        //     $: "jquery" 
        // }) 

        
        //从js中抽取css单独打包;一旦抽取了css就不需要cssloader了，需要换成这个插件里面的loader。单独打包css
        new MiniCssExtracPlugin({
            filename:'css/[name].css'
        }),

        
    ],

    //开发服务器
    devServer:{
        open:true   //自动打开浏览器访问
    },


    //优化配置
    optimization:{
        minimizer:[new OptimizeCssAssetsPlugin()]
    }

}

以上是关于webpack配置的主要内容，如果未能解决你的问题，请参考以下文章

webpack配置bable

webpack配置

Webpack 配置

webpack vue 热部署配置

webpack基础+webpack配置文件常用配置项介绍+webpack-dev-server

webpack基础+webpack配置文件常用配置项介绍+webpack-dev-server