webpack的安装与配置使用最全最详细的小白教学

webpack 的基础概念

理解: webpack本身是node的一个第三方模块包, 用于打包代码

webpack官网

现代 javascript 应用程序的静态模块打包器 (module bundler)
为要学的 vue-cli 开发环境做铺垫

webpack 介绍

作用:把很多文件打包整合到一起, 缩小项目体积, 提高加载速度

常用 loader

less-loader

用于将 less 编译成 css

css-loader

用于将 css 以 CommonJs 语法打包到 JS 中
配合 style-loader共同使用

style-loader

用于动态创建 style 标签，负责把包含 css 内容的 js 代码挂载到页面的 style 标签当中
但是这样子打包出来的文件 css 样式和结构糅杂在一起可以用 mini-css-extract-plugin 插件来将 css 提取为单独的文件下面会介绍

sass-loader

css预处理器

postcss-loader

用于补充css样式各种浏览器内核前缀，用于处理css兼容问题，需要和postcss、postcss-preset-env配合使用。
备注1:使用的规则为：[“css-loader”,“postcss-loader”,“less-loader”]
备注2:需要在package.json中配置browserslist属性指定具体的兼容规则
备注3:browserslist是一个单独的库，被广泛用在各种涉及浏览器/移动端的兼容性支持工具中

babel-loader

将Es6+ 语法转换为Es5语法(只能转换简单的es6+语法)

babel-loader 这是使babel和webpack协同工作的模块

@bable/core 这是babel编译器核心模块

@babel/preset-env 这是babel官方推荐的预置器，可根据用户的环境自动添加所需的插件和补丁来编译Es6代码；备注1:直接使用只能处理简单的语法，Promise等无法处理。备注2:借助polyfill完成高级es6语法的转换，缺点：所有都转换，无法按需转换，生成的js体积大。备注3:生成的js体积大使用core-js配合polyfill完成按需转换。

ts-loader

用于配置项目 typescript

html-loader

将 HTML 导出为字符串。当编译器需要时，将压缩 HTML 字符串。

file-loader

用于处理文件类型资源常用于打包 jpg、png 等图片

url-loader

将文件作为 data URI 内联到 bundle 中

raw-loader

将文件导入为字符串

eslint-loader

用于检查代码是否符合规范，是否存在语法错误

常用 Plugin 插件

html-webpack-plugin

自动打包创建html文件(或者指定 html 模板)，并且引入外部资源如 js css等

mini-css-extract-plugin

将 CSS 提取为独立的文件的插件，对每个包含 css 的 js 文件都会创建一个 CSS 文件，支持按需加载 css 和 sourceMap。

css-minimizer-webpack-plugin

用于压缩css，减小 css 打包后的体积

eslint-webpack-plugin

该插件使用 eslint 来查找和修复 JavaScript 代码中的问题。校验 js 格式

clean-webpack-plugin

自动删除已经打包过的文件这样每次重新打包的时候就不用手动删除文件夹了

copy-webpack-plugin

用于打包静态文件

stylelint-webpack-plugin

校验 css 格式

webpack 项目的创建

创建项目

新建项目目录，目录结构和之前的规范不同
根目录创建 public
创建 index.html

<body><div>轮播图111</div><div>轮播图222</div></body><scriptsrc="../src/index.js"></script>

创建 src 存放源代码等资源文件
创建 index.js

console.log('webpack 创建项目')

将逻辑进行模块化
创建 banner.js

console.log('这是banner.js的内容')

创建 table.js

console.log('这是table.js的内容')

解决多次引用资源文件

资源文件过多时如 js****css 资源会重复导入此时可以在 index.js 中引入banner.js 和 table.js

import'./banner.js'import'./table.js'

然后在 index.html 中引入 index.js

<body><div>轮播图</div><div>tabs标签页</div></body><scriptsrc="../src/index.js"></script>

然后此时浏览器会报错
原因是 import 是使用 EsModule 规范解析的而在 js 文件中默认以 CommonJs 规范进行解析此时可以在 **< script >**标签 type 属性加上 module 使用 EsModule 规范解析这样子就不会报错了

<body><div>轮播图</div><div>tabs标签页</div></body><scriptsrc="../src/index.js"type="module"></script>

webpack 安装

初始化包环境

npm init

安装依赖包注意要使用开发者模式安装 -D

npm i webpack webpack-cli -D

在 package.json 中配置 scripts (自定义命名)

"scripts":{"build":"webpack"}

运行命令进行打包

npm run build

webpack 的使用

webpack 配置入口和出口

目标: 告诉webpack从哪开始打包, 打包后输出到哪里

创建 webpack.config.js 文件
填入配置项

const path =require("path")

module.exports ={entry:"./src/main.js",// 入口文件output:{// 配置出口文件的命令 必须是绝对命令path: path.join(__dirname,"dist"),// 出口路径filename:"bundle.js"// 出口文件名}}

自动生成html文件

目标: html-webpack-plugin插件, 让webpack打包后生成html文件并自动引入打包后的js

下载插件

    yarn add html-webpack-plugin  -D

webpack.config.js 配置

// 引入自动生成 html 的插件const HtmlWebpackPlugin =require('html-webpack-plugin')

    module.exports ={// ...省略其他代码plugins:[newHtmlWebpackPlugin()]}

重新打包后观察dist下是否多出html并运行看效果打包后的index.html自动引入打包后的js文件
自定义打包的html模版，和输出文件名字,指定标题

plugins:[newHtmlWebpackPlugin({template:'./public/index.html',title:'webpack测试',filename:'index.html'})]

mode模式

mode模式分为 开发阶段 和 发布阶段
开发阶段 development ，简易打包，打包速度快
发布阶段 production ，打包精细，打包速度慢（但是没关系不会经常production）

mode:'development || production'

webpack开发服务器

文档地址: https://webpack.docschina.org/configuration/dev-server/

抛出问题: 每次修改代码, 都需要重新 npm run build 打包, 才能看到最新的效果, 实际工作中, 打包 yarn build 非常费时 (30s - 60s) 之间

为什么费时?

构建依赖
磁盘读取对应的文件到内存, 才能加载
将处理完的内容, 输出到磁盘指定目录

解决问题: 起一个开发服务器, 在电脑内存中打包, 缓存一些已经打包过的内容, 只重新打包修改的文件, 最终运行加载在内存中给浏览器使用

webpack-dev-server

目标: 启动本地服务, 可实时更新修改的代码, 打包
变化代码
到内存中, 然后直接提供端口和网页访问

下载包

    npm install webpack-dev-server -D

配置自定义命令

scripts:{"build":"webpack","serve":"webpack serve"}

运行命令-启动webpack开发服务器

    yarn serve
    或者 npm run server

总结: 以后改了src下的资源代码, 就会直接更新到内存打包, 然后反馈到浏览器上了

webpack-dev-server 配置

Package.json

    "scripts": {
      "build": "webpack",
      "serve": "webpack serve --port 8083 --open"
    },

在webpack.config.js中添加服务器配置

更多配置参考这里: https://webpack.docschina.org/configuration/dev-server/#devserverafter

    module.exports ={devServer:{// 指定加载内容的路劲static:resolve(__dirname,'output'),port:3000,// 端口号// open: true,// 启用gzip压缩 能够以75%的压缩率压缩资源compress:true,// 启动热重载hot:false,liveReload:true,// 配置代理服务器proxy:{//表示请求的接口的前缀'/api':{target:'https://api.github.com',//请求的服务端地址 //重写路劲pathRewrite:{'^/api':''}},//改变请求的地址changeOrigin:true}},}

打包 css 文件

处理 css 文件的问题

目标: 自己准备css文件, 引入到webpack入口, 测试webpack是否能打包css文件

1.新建 - src/styles/index.css

2.编写样式

.banner{width: 100px;height: 100px;background-color: hotpink;}

3.(重要) 一定要引入到入口才会被webpack打包

4.执行打包命令观察效果

在这里插入图片描述

总结: 保存原因, 因为 webpack 默认只能处理 js 类型文件

处理 css 文件

目标: loaders加载器, 可让webpack处理其他类型的文件, 打包到js中
原因: webpack默认只认识 js 文件和 json文件

安装依赖

    yarn add style-loader css-loader -D
    或者 npm i style-loader css-loader -D

webpack.config.js 配置

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

    module.exports ={// ...其他代码module:{rules:[// loader的规则{test:/\.css$/,// 匹配所有的css文件// use数组里从右向左运行// 先用 css-loader 让webpack能够识别 css 文件的内容并打包// 再用 style-loader 将样式, 把css插入到dom中// use表示使用指定的loader来处理指定的类型的文件use:["style-loader","css-loader"]}]}}

将 css 文件单独打包出来

目标: 使用 mini-css-extract-plugin 插件将 js 文件中的 CSS 提取为独立文件

安装插件

 npm i mini-css-extract-plugin -D

webpack.config.js 配置

导入模块

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

module 配置

module:{rules:[// 指定多个配置规则{// 匹配后缀是.css的文件test:/\.css$/,// use表示使用指定的loader来处理指定的类型的文件use:[// 注意！！：在处理css文件时候，各个loader的使用有先后顺序的// use数组中，loader的加载顺序是从下往上(从后往前)，即从最后一个loader先执行，然后往前//// 负责把包含css内容的js代码挂载到页面的style标签中// "style-loader",{loader: MiniCssExtractPlugin.loader,options:{//代替相对路径 ./ 或者 ../ publicPath:'../'}},// css-loader负责遍历src的所有css文件，将css打包输出到打包后的js文件中"css-loader",]},}

plugins 配置

plugins:{// 2、把打包的单独的css文件放到打包的指定的输出目录中newMiniCssExtractPlugin({// 把打包之后的单独的css文件放到output目录下的css目录中// [name]表示打包之后的文件名称和原来的文件名称一样filename:'css/[name].css'}),}

总结: 万物皆模块, 引到入口, 才会被webpack打包, css打包进js中, 然后被嵌入在style标签插入dom上

css 兼容性处理

安装依赖包

 npm install postcss-loader postcss -D

autoprefixer 自动添加浏览器厂商前缀

创建 postcss.config.js 文件
在导入 autoprefixer 模块 autoprefixer 自动添加浏览器厂商前缀
postcss.config.js 内容

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

webpack 配置

{// 匹配后缀是.css的文件test:/\.css$/,// use表示使用指定的loader来处理指定的类型的文件use:[// 注意！！：在处理css文件时候，各个loader的使用有先后顺序的// use数组中，loader的加载顺序是从下往上(从后往前)，即从最后一个loader先执行，然后往前//// 负责把包含css内容的js代码挂载到页面的style标签中// "style-loader",{loader: MiniCssExtractPlugin.loader,options:{publicPath:'../'}},// css-loader负责遍历src的所有css文件，将css打包输出到打包后的js文件中"css-loader",'postcss-loader',]},

打包 less 文件

加载 less 问题

新建less样式


    body {
      .tabs {
        width: 400px;
        height: 40px;
        background-color: pink;
      }
    }

引入less样式

import'./banner.js'import'./tabs.js'import'./styles/index.css'
    console.log(132)

报错

处理less文件

目标: less-loader让webpack处理less文件, less模块翻译less代码

less-loader文档

安装 less-loader

    yarn add less less-loader -D

webpack.config.js 配置

module:{rules:[// loader的规则// ...省略其他{test:/\.less$/,// 使用less-loader, 让webpack处理less文件, 内置还会用less翻译less代码成css内容use:["style-loader","css-loader",'less-loader']}]}

{test:/\.less$/,use:[// compiles Less to CSS// 'style-loader',{loader: MiniCssExtractPlugin.loader,options:{publicPath:'../'}},'css-loader','postcss-loader','less-loader',],},

打包图片

处理图片的问题

将资源文件复制到项目中

定义盒子结构

<divclass="box"></div><divclass="box1"></div>

通过样式设置背景图

.box{width: 100px;height: 100px;background-image:url(../assets/logo_small.png);}.box2{width: 100px;height: 100px;background-image:url(../assets/gif);}

加载器-处理图片

目标: 用asset module方式(webpack5版本新增)
在指南里面
asset module文档
如果使用的是webpack5版本的, 直接配置在webpack.config.js - 的 rules里即可

{test:/\.(png|jpg|gif|jpeg)$/i,// asset/resource 发送一个单独的文件并导出 URL。之前通过使用 file-loader 实现。// asset/inline 导出一个资源的 data URI。之前通过使用 url-loader 实现。// asset/source 导出资源的源代码。之前通过使用 raw-loader 实现// asset 在导出一个 data URI 和发送一个单独的文件之间自动选择。之前通过使用 url-loader，并且配置资源体积限制实现。type:'asset',parser:{// 限制体积 小于8kb的文件采用 asset/inline 的方式转成 base64 URL。如果大于8kb 采用 asset/resource 导出文件dataUrlCondition:{mixSize:8*1024// 8kb}},// 输出文件目录generator:{filename:"images/[name].[ext]"},}

如果你用的是webpack4及以前的, 请使用 url-loader****file-loader 文档者里的配置
作为了解

下载依赖包

    yarn add url-loader file-loader -D
    或者 npm i url-loader file-loader -D

webpack.config.js 配置

{test:/\.(png|gif|ico|jpe?g)/,// use:{//     loader:'file-loader',//     options: {//         esModule:false//     }// },use:{loader:'url-loader',options:{// 限定图片大小，小于这个大小，图片会被转换成base64的格式limit:8*1024,name:"[name].[ext]",// 表示原来图片的名称是什么，原来图片的扩展名是什么，那么打包之后就是什么esModule:false}},type:'javascript/auto'// type: 'asset',// parser: {//     dataUrlCondition: {//         maxSize: 8 * 1024 // 8kb//     }// },// generator: {//     filename: "images/[name].[ext]"// }},

src/assets/ 准备2个图文件
在 css/less/index.less 把小图片用做背景图

body{background:url(../assets/logo_small.png) no-repeat center;}

在 src/main.js - 把大图插入到创建的img标签上, 添加body上显示

// 引入图片-使用import imgUrl from'./assets/gif'const theImg = document.createElement("img")
    theImg.src = imgUrl
    document.body.appendChild(theImg)

打包运行 dist/index.html 观察2个图片区别

总结: url-loader 把文件转base64 打包进js中, 会有30%的增大, file-loader 把文件直接复制输出

webpack加载文件优缺点

以8kb进行区分，小于8kb图片转成 base64 字符串 - 好处就是浏览器不用发请求了，直接可以读取- 坏处就是如果图片太大，再转base64就会让图片的体积增大 30% 左右

处理字体文件

目标: 用asset module技术, asset/resource直接输出到dist目录下

src/assets/ - 放入字体库fonts文件夹
在main.js引入iconfont.css

// 引入字体图标文件import'./assets/fonts/iconfont.css'

在public/index.html使用字体图标样式

<iclass="iconfont icon-weixin"></i>

webpack5使用这个配置,也可以不配置

{// webpack5默认内部不认识这些文件, 所以当做静态资源直接输出即可test:/\.(eot|svg|ttf|woff|woff2)$/,type:'asset/resource',generator:{filename:'font-[name].[hash:6][ext]'}}

webpack4及以前使用下面的配置

webpack.config.js - 准备配置

{// 处理字体图标的解析test:/\.(eot|svg|ttf|woff|woff2)$/,use:[{loader:'url-loader',options:{limit:2*1024,// 配置输出的文件名name:'[name].[ext]',// 配置输出的文件目录outputPath:"fonts/"}}]}

执行打包命令-观察打包后网页效果

总结: url-loader 和 file-loader 可以打包静态资源文件

打包静态资源

类似于像 favicon.ico 这类文件不需要打包的可以使用 copy-webpack-plugin 插件来打包

在 src 目录下创建一个 public 的文件夹存放静态资源

const CopyWebpackPlugin=require('copy-webpack-plugin')plugins:[newCopyWebpackPlugin({patterns:[{from:"./src/public",to:"public"},],}),]

处理ES6+ 基本语法

目标: 让webpack对高版本的js代码, 降级处理后打包

高版本的js代码(箭头函数、类), 打包后, 直接原封不动打入了js文件中, 遇到一些低版本的浏览器就会报错

原因:

webpack 默认仅内置了 模块化的 兼容性处理

import export

babel 的介绍 => 用于处理高版本 js语法的兼容性 babel官网

解决: 让webpack配合babel-loader 对js语法做处理

@babel/core：

@babel/core是babel的核心库，所有的核心Api都在这个库里，这些Api供babel-loader调用

@babel/preset-env：

这是一个预设的插件集合，包含了一组相关的插件，Bable中是通过各种插件来指导如何进行代码转换。该插件包含所有es6转化为es5的翻译规则

安装包

    npm install  babel-loader @babel/core @babel/preset-env -D

配置规则

module:{rules:[{test:/\.js$/,exclude:/(node_modules)/,use:{loader:'babel-loader',options:{presets:['@babel/preset-env']// 预设:转码规则(用bable开发环境本来预设的)}}}]}

总结: babel-loader 可以让webpack 对高版本js语法做降级处理后打包

处理 ES6+ 高级语法

在index.js文件中导入 import ‘@babel/polyfill’

import'@babel/polyfill'

console.log('xxx=>',data)// 转译js高阶代码constshowMsg=()=>{
    console.log('Hello Webpack')}// 转译更高阶语法const p =newPromise(resolve=>{setTimeout(()=>{
        console.log('Promise is working')resolve()},1000)})
console.log(p)

window.showMsg = showMsg

但是这样子会造成文件的体积变大因为 @babel/polyfill 是一个集成包所以可以导入 core.js 实现按需加载

配置 webpack.config.js

// js转换{test:/\.m?js$/,exclude:/node_modules/,use:{loader:'babel-loader',options:{presets:[['@babel/preset-env',{// 按需加载useBuiltIns:'usage',// 指定core.js的版本，也就是在package.json中的core.js的版本corejs:{version:3}}]]}}}

把 index.js文件中的 import ‘@babel/polyfill’ 注释掉

// 注意：引入了core-js，要把polyfill这一行注释掉// import '@babel/polyfill';

console.log('xxx=>', data);// 转译js高阶代码constshowMsg=()=>{
  console.log('Hello Webpack');};// 转译更高阶语法const p =newPromise((resolve)=>{setTimeout(()=>{
    console.log('Promise is working');resolve();},1000);});
console.log(p);
window.showMsg = showMsg;functiontestJsLint(){ console.log('xxx');}

总结

什么是webpack, 它有什么作用
知道yarn的使用过程, 自定义命令, 下载删除包
有了webpack让模块化开发前端项目成为了可能, 底层需要node支持
对webpack各种配置项了解 - 入口/出口- 插件- 加载器- mode模式- devServer
webpack开发服务器的使用和运作过程

标签： webpack 前端 javascript

本文转载自: https://blog.csdn.net/llq007007/article/details/129016192
版权归原作者 小七不懂前端 所有，如有侵权，请联系我们删除。