经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » JS/JS库/框架 » JavaScript » 查看文章
Webpack 5 配置手册（从0开始）
来源：cnblogs　　作者：heyaiyang　　时间：2021/3/29 9:09:24　　对本文有异议

针对新手入门搭建项目，Webpack5 配置手册（从0开始）

webpack安装顺序

  1. 1. `npm init -y`，初始化包管理文件 package.json
  2. 2. 新建src源代码目录
  3. 3. 新建index.html
  4. 4. `yarn add webpack webpack-cli`,安装webpack相关包
  5. 5. 在项目根目录中，创建webpack.config.js 的配置文件
  6. 6. `yarn add webpack-dev-server`,安装支持项目自动打包的工具，并配置
  7. 7. `yarn add html-webpack-plugin`,安装生成预览页面插件并配置
  8. 8. `yarn add style-loader css-loader`,安装处理css文件的loader
  9. 9. `yarn add less-loader less`,安装处理less文件的loader
  10. 10. `yarn add sass-loader node-sass`,安装处理scss文件的loader
  11. 11. `yarn add postcss postcss-loader postcss-preset-env autoprefixer`,配置postCSS自动添加css的兼容前缀（可选）
  12. 12. `yarn add url-loader file-loader`,安装处理css文件中的图片和字体文件
  13. 13. `yarn add html-loader`,安装处理html文件中的图片和字体文件
  14. 14. `yarn add @babel/core babel-loader @babel/preset-env 前面3个是必须的，后面的看需要 @babel/plugin-transform-runtime @babel/plugin-proposal-class-properties`,安装处理js高级语法（ES6以上）
  15. 15. 之后看下面的插件安装代码。
  1. yarn add html-webpack-plugin
  2. yarn add style-loader css-loader
  3. yarn add less-loader less
  4. yarn add sass-loader node-sass
  5. yarn add url-loader file-loader
  6. yarn add html-loader
  7. yarn add @babel/core babel-loader @babel/preset-env 前面3个是必须的，后面的看需要 @babel/plugin-transform-runtime @babel/plugin-proposal-class-properties
  8. yarn add postcss postcss-loader postcss-preset-env
  9. yarn add mini-css-extract-plugin
  10. yarn add optimize-css-assets-webpack-plugin
  11. yarn add eslint eslint-loader eslint-webpack-plugin
  12. yarn add eslint-config-airbnb-base 或 eslint-config-airbnb 或 vue的eslint
  13. yarn add clean-webpack-plugin

使用npx babel-upgrade将所有关于babel的插件都升级都最新版本以适应兼容性

在.babelrc 中配置，或者在package.json中直接添加

  1. {
  2.   "presets": ["@babel/preset-env"],
  3.   "plugins": [
  4.     "@babel/plugin-transform-runtime",
  5.     "@babel/plugin-proposal-class-properties"
  6.   ]
  7. }

webpack.config.js中配置插件

  1. const path = require('path');
  2. const htmlWebpackPlugin = require('html-webpack-plugin');
  3. const { CleanWebpackPlugin } = require('clean-webpack-plugin');
  5. module.exports = {
  6.   mode: 'development',
  7.   entry: path.join(__dirname, './src/main.js'),
  8.   output: {
  9.     path: path.join(__dirname, './dist'),
  10.     filename: 'bundle.js',
  11.   },
  12.   // 插件
  13.   plugins: [
  14.     // html
  15.     new htmlWebpackPlugin({
  16.       template: path.join(__dirname, './src/index.html'),
  17.       filename: 'index.html',
  18.     }),
  19.     // 打包前清除dist
  20.     new CleanWebpackPlugin(),
  21.   ],
  22.   // Loaders 部分
  23.   module: {
  24.     rules: [
  25.       {
  26.         // test设置需要匹配的文件类型，支持正则
  27.         test: /\.css$/,
  28.         // use表示该文件类型需要调用的loader
  29.         use: ['style-loader', 'css-loader'],
  30.       },
  31.       {
  32.         test: /\.less$/,
  33.         use: ['style-loader', 'css-loader', 'less-loader'],
  34.       },
  35.       {
  36.         test: /\.scss$/,
  37.         use: ['style-loader', 'css-loader', 'sass-loader'],
  38.       },
  39.       {
  40.         test: /\.(png|gif|bmp|jpg)$/,
  41.         use: {
  42.           loader: 'url-loader',
  43.           options: {
  44.             limit: 8 * 1024,
  45.             // 图片取10位hash和文件扩展名
  46.             name: '[hash:10].[ext]',
  47.             // 关闭es6模块化
  48.             esModule: false,
  49.             //  图片资源的输出路径
  50.             outputPath: 'images',
  51.           },
  52.         },
  53.       },
  54.       // 处理html中img资源
  55.       {
  56.           test: /.\html$/,
  57.           loader: "html-loader"
  58.       },
  59.       //  处理其他资源(一般指的就是字体资源等)
  60.       // {
  61.       //     exclude: /\.(html|js|css|less|scss|jpg|png|gif)/,
  62.       //     loader: "file-loader",
  63.       //     outputPath:'media'
  64.       // },
  65.       {
  66.         test: /\.(woff(2)?|eot|ttf|otf|svg|)$/,
  67.         type: 'asset/inline',
  68.       },
  69.       {
  70.         test: /\.js/,
  71.         exclude: /node_modules/,
  72.         use: {
  73.           loader: 'babel-loader',
  74.           options: {
  75.             presets: ['@babel/preset-env'],
  76.             plugins: ['@babel/plugin-proposal-class-properties'],
  77.           },
  78.         },
  79.       },
  80.     ],
  81.   },
  82.   // 使用webpck-dev-server时配置
  83.   devServer: {
  84.     historyApiFallback: true,
  85.     contentBase: path.join(__dirname, './dist'),
  86.     open: true,
  87.     hot: true,
  88.     quiet: true,
  89.     port: 3000,
  90.   },
  91. };

webpack.config.js中配置插件

  1. const { resolve } = require('path');
  2. const MiniCssExtractPlugin = require('mini-css-extract-plugin');
  3. const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin');
  4. const HtmlWebpackPlugin = require('html-webpack-plugin');
  5. const ESLintPlugin = require('eslint-webpack-plugin');
  6. // 导入每次删除文件夹的插件
  7. const { CleanWebpackPlugin } = require('clean-webpack-plugin');
  9. // 复用loader加载器
  10. const commonCssLoader = [
  11.   MiniCssExtractPlugin.loader,
  12.   'css-loader',
  13.   // css兼容性处理
  14.   // 还需要在package.json中定义browserlist
  15.   'postcss-loader'
  16.   // 下面是根据路径找配置文件
  17.   // {
  18.   //   loader: 'postcss-loader',
  19.   //   options: {
  20.   //     postcssOptions:{
  21.   //       config:'./postcss.config.js'
  22.   //     }
  23.   //   }
  24.   // }
  25. ];
  27. // 定义node.js到环境变量，决定使用browserslist的哪个环境
  28. process.env.NODE_ENV = 'production';
  30. module.exports = {
  31.   entry: './src/main.js',
  32.   output: {
  33.     filename: 'js/bundle.js',
  34.     path: resolve(__dirname, 'dist')
  35.   },
  36.   module: {
  37.     rules: [
  38.       {
  39.         test: /\.css$/,
  40.         use: [
  41.           ...commonCssLoader,
  42.         ]
  43.       },
  44.       {
  45.         test: /\.less$/,
  46.         use: [
  47.           ...commonCssLoader,
  48.           'less-loader'
  49.         ]
  50.       },
  52.       // {
  53.       //   // eslint语法检查，在package.json中eslintConfig --> airbnb的校验规则
  54.       //   test: /\.js$/,
  55.       //   exclude: /node_modules/,
  56.       //   // 优先执行，先执行eslint在执行babel
  57.       //   enforce: 'pre',
  58.       //   loader: 'eslint-loader',
  59.       //   options: {
  60.       //     fix: true
  61.       //   }
  62.       // },
  63.       {
  64.         // js代码兼容性处理
  65.         test: /\.js$/,
  66.         exclude: /node_modules/,
  67.         loader: 'babel-loader',
  68.         options: {
  69.           presets: [
  70.             ['@babel/preset-env', //基础预设
  71.               {
  72.                 useBuiltIns: 'usage', // 按需加载
  73.                 corejs: {
  74.                   version: 3
  75.                 },
  76.                 targets: {
  77.                   // 兼容到什么版本到浏览器
  78.                   chrome: '60',
  79.                   firefox: '50',
  80.                   ie: '9',
  81.                   safari: '10',
  82.                   edge: '17'
  83.                 }
  84.               }
  85.             ]],
  86.           plugins: ['@babel/transform-runtime','@babel/plugin-proposal-class-properties'],
  87.         }
  88.       },
  89.       {
  90.         test: /\.(png|gif|bmp|jpg)$/,
  91.         use: {
  92.           loader: 'url-loader',
  93.           options: {
  94.             limit: 8 * 1024,
  95.             // 图片取10位hash和文件扩展名
  96.             name: '[hash:10].[ext]',
  97.             // 关闭es6模块化
  98.             esModule: false,
  99.             //  图片资源的输出路径
  100.             outputPath: 'images',
  101.             // publicPath :  这个则是生成的页面中对图片路径的引用时，加上publicPath。
  102.             publicPath: "../images"
  103.           }
  104.         }
  105.       },
  106.       // 处理html中img资源
  107.       {
  108.         test: /.\html$/,
  109.         loader: 'html-loader'
  110.       },
  111.       // 处理其他?件
  112.       {
  113.         exclude: /\.(js|css|less|html|jpg|png|gif)/,
  114.         loader: 'file-loader',
  115.         options: { outputPath: 'media', },
  116.       },
  117.     ]
  118.   },
  119.   plugins: [
  120.     // css代码单独抽离
  121.     new MiniCssExtractPlugin({
  122.       filename: 'css/bundle.css'
  123.     }),
  124.     // css代码压缩
  125.     new OptimizeCssAssetsWebpackPlugin(),
  126.     // html文件压缩
  127.     new HtmlWebpackPlugin({
  128.       template: './src/index.html',
  129.       minify: {
  130.         // 移除空格
  131.         collapseWhitespace: true,
  132.         // 移除注释
  133.         removeComments: true
  134.       }
  135.     }),
  136.     // new ESLintPlugin({
  137.     //   exclude:'node_modules',
  138.     //   fix:true
  139.     // }),
  140.     new CleanWebpackPlugin(),
  141.   ]
  142.   ,
  143.   mode: 'production'
  144. };

postcss.config.js配置

  1. module.exports = {
  2.   // You can specify any options from https://postcss.org/api/#processoptions here
  3.   // parser: 'sugarss',
  4.   plugins: [
  5.     // Plugins for PostCSS
  6.     // ["postcss-short", { prefix: "x" }],
  7.     "postcss-preset-env",
  8.   ],
  9. };

.eslintlrc.js配置

  1. module.exports = {
  2.   root: true,
  3.   env: {
  4.     commonjs: true,
  5.     es6: true,
  6.     browser: true,
  7.     node: true
  8.   },
  9.   extends: [
  10.     "airbnb-base",
  11.     // 'plugin:vue/essential',
  12.     // '@vue/standard'
  13.   ],
  14.   parserOptions: {
  15.     ecmaVersion: 7,
  16.     ecmaFeatures: {
  17.       jsx: true,
  18.       experimentalObjectRestSpread: true,
  19.     },
  20.     parser: 'babel-eslint',
  21.     sourceType: "module"
  22.   },
  23.   rules: {
  24.     'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
  25.     'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off'
  26.   }
  27. }

.gitignore配置

  1. node_modules/*
  2. package-lock.json
  3. dist/*
  4. .idea/*

package.json配置

  1. {
  2.   "scripts": {
  3.     "test": "echo \"Error: no test specified\" && exit 1",
  4.     "serve": "webpack serve",
  5.     "dev": "webpack --config webpack.config.js",
  6.     "build": "webpack --config webpack.pub.config.js"
  7.   },
  8.   "browserslist": {
  9.     "development": [
  10.       "last 1 chrome version",
  11.       "last 1 firefox version",
  12.       "last 1 safari version"
  13.     ],
  14.     "production": [
  15.       ">0.2%",
  16.       "not dead",
  17.       "not op_mini all"
  18.     ]
  19.   }
  20. }

遇到的问题

  1. 开发环境，热部署devServer的重新配置，在webpack.config.js中添加热部署的部分代码，之后在package.json
    文件内scripts中配置相应的webpack
  2. 生产环境在package.json中的配置"build": "webpack --config webpack.pub.config.js"
  3. 生产环境图片资源打包之后，网页显示不出来，需要在图片资源的打包中添加publicPath: "../images",这个
    则是生成的页面中对图片路径的引用时，加上publicPath,这样访问时姐可以放到文件的正确地址了。
  4. css代码的兼容性处理，使用postcss-loader的配置，可以直接在use里加载postcss-loader的配置文件，也可以直接
    使用postcss-loader,让后打包时自动在根目录中找postcss.confgi.js配置文件，来加载postcss配置，此项目使用的
    外部postcss.confgi.js配置文件的配置方式。注意：还需要在package.json中定义browserlist
  5. 另外：目前还有生产环境懒加载和eslint校验代码的功能未完成，eslint的校验遇到问题class Person { static info = { name: 'zs' }; }，在生产环境的webpack.pub.config.js中引入来插件eslint-webpack-plugin，配置了new ESLintPlugin(),
    但是提示错误信息如下，Parsing error: Unexpected token =

gitee 仓库地址

https://gitee.com/heyhaiyon/webpack5-config

原文链接：http://www.cnblogs.com/heyhaiyang/p/14459583.html

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

JavaScript热门文章

  • echarts 饼图 + 全屏显示
  • js正则匹配以{开头,以}结尾的表达式怎么写？-附源码
  • echarts 实现数据(tooltip)自动轮播插件
  • Js设置博客园主题色(theme-color)
  • elementUI 设置input的只读或禁用的方法
  • 超级好用的流程图js框架 值得收藏
  • layui table+复杂表头+合并单元格
  • 获取地理位置
  • 如何使用JavaScript导入和导出Excel文件
  • WebStorm eslint插件报错解决 - TypeError: this.CliEngine is not a constructor

    • JavaScript推荐文章

  • 一些八股：1.fetch 的理解。2.let、const、var
  • 电子表格转身购物车：三步轻松实现
  • Canvas简历编辑器-图形绘制与状态管理(轻量级DOM)
  • IntersectionObserver + scrollIntoView 实现电梯导航 - xingba-coder
  • 可视化—gojs 超多超实用经验分享(三)
  • PixiJS源码分析系列： 第一章 从最简单的例子入手
  • WebRTC入门
  • 前端 Array.sort() 源码学习
  • 【技巧】JS代码这么写，前端小姐姐都会爱上你
  • 【JS】await异常捕获，这样做才完美

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号