webpack详细教程

1，什么是webpackwebpack | webpack中文文档 | webpack中文网

• Webpack 不仅是一个模块打包器(bundler)，更完整的讲是一个前端自动化构建工具。
• 在 Webpack 看来前端的所有资源文件(s/json/css/img/less/...)都会作为横块处理
• 它将根据模块的依赖关系进行静态分析，生成对应的静态资源.

五个核心概念 

• Entry:入起点(entry point)指示 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。
• Output:output 属性告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件
• Loader: loader让webpack 能够去处理那些非JavaScript 文件
• Plugins: 插件则可以用于执行范围更广的任务。例:打包优化、压缩
• Mode:横式，有生产模式 production 和开发模式development

理解Loader

• Webpack 本身只能加载JS/JSON 块，如果要加载其他类型的文件(模块)，就需要使用对应的loader进行转换/加载。
• Loader 本身也是运行在 node.js 环境中的JavaScript 横块。
• 本身是一个函数，接受源文件作为参数，返回转换的结果。
•  loader 一般以xxx-loader 的方式命名，xxx代表了这个 loader 要做的转换功能，比如 less-loader。

理解Pligins

• 插件可以完成一些loader 不能完成的功能。
• 插件的使用一般是在 webpack 的配置信息 plugins 选项中指定。

Mode

• 模式(Mode)指示 webpack 使用相应模式的配置

配置文件(默认)

•  webpack.configjs:是一个 node 模块，返回一个json 格式的配置信息对象

 2，安装webpack

• 全局安装（这一步暂时不需要做）

npm install webpack webpack-cli -g

• 局部安装

npm init
npm install webpack webpack-cli -D   # cli  Command Line Interface 命令行接口

官方推荐使用『局部安装』，这样可以避免因为版本不同而产生的 BUG

3，webpack初体验 

 1.创建JS模块: src/index.js

import data from './data.json'

console.log(data)

function add(x,y){
    return x + y;
}

console.log(add(1,2))

2,创建JSON模块: src/data.json

{
    "name":"jack",
    "age":18
}

3,创建css文件: src/index.css

html,body{
    height: 100%;
    background-color: pink;
}

4,安装

npm init -y
npm i webpack webpack-cli -D

5，执行打包命令 『项目根目录下运行』

# 开发模式打包
npx webpack --entry ./src/index.js  --output-path ./build/js --output-filename bundle.js --mode development

webapck会以 ./src/index.js为入口文件开始打包，打包后输出到 ./build/bundle.js整体打包环境，是开发环境

# 生产模式打包
npx webpack --entry ./src/index.js  --output-path ./build/js --output-filename bundle2.js --mode production

webapck会以 ./src/index.js为入口文件开始打包，打包后输出到 ./build/bundle.js整体打包环境，是生产环境（对代码进行压缩到只剩下一行代码，在开发项目中对代码进行一个打包，解析速度等会变快）

• –entry 设置入口
• –output-path 设置输出目录
• –output-filename 设置输出文件名
• –mode 设置运行模式

区别 npm 与 npx ?

它们都是由Node提供的2个工具, 用来做工具包的相关处理
npm (Node Package Manager) : 包管理器, 用来下载工具包
npx (Node Package Excuted) : 包扩展工具, 用来运行工具包命令
npx 查找工具包的顺序: 局部查找 ==> 全局查找 ==> 运行

但是当在index.js中引入css样式，会进行一个报错

import "./index.css"

所以我们得到一个结论：

1.webpack能处理js/json资源，不能处理css/img等资源

2.生产环境和开发环境将ES6模块化编译成浏览器能识别的模块化~

3.生产环境比开发环境多一个压缩js代码

4，使用配置文件打包

问题：打包命令太复杂(需要指定打包的各种配置信息)

解决：通过JS类型的配置文件来指定打包的配置信息

项目根目录下创建文件 webpack.config.js，内容如下

const {resolve} = require('path'); // path模块是Node内置的
// __dirname：当前配置文件所在的目录绝对路径
// resolve: 用来拼接路径的函数

// 暴露配置对象
module.exports = {
    // 入口
    entry: './src/index.js',
  
    // 出口
    output: {
        path: resolve(__dirname, 'build'), // 打包文件所在的根目录
        filename: 'js/bundle.js', // 打包生成的js文件名(可以带目录)
        clean: true, // 打包时, 会先自动清空打包文件夹
    },
   
    // 模式
  	// mode: 'production',
    mode: 'development',
}

 创建完毕之后，在项目根目录执行如下命令：

npx webpack

5，打包样式

切记，以下内容需要在配置文件打包的基础上进行添加，直接使用会报错

问题：webpack本身只能打包 JS 文件和 JSON 文件, 不能打包CSS文件

解决：利用css-loader & style-loader & less-loader 对CSS进行打包处理

首先是我们的准备工作

1,创建css文件：./src/index.css

html,body{
    margin: 0;
    padding: 0;
    height: 100%;
    background-color: pink;
}

2,创建less文件：./src/index.less

#title{
    color: #fff;
}

3.在入口JS文件中引入这些资源：./src/index.js

// 引入样式资源
import './index.css'  //只下载css-loader就只引入css文件 不然会报错
import './index.less' //只下载less-loader就只引入less文件 不然会报错

5-1：打包css文件

第一步：安装loader

npm i style-loader css-loader -D

第二步：修改webpack.config.js配置文件

module.exports = {
    mode: 'development',
    
    // 配置 loader
    module: {
        rules: [
          	// 配置 css 文件处理
            {
                test: /\.css$/, // 处理css文件
                use: [
                    "style-loader",		// 将 CSS 生成 style 标签插入 HTML 中
                    "css-loader"  		// 将 CSS 转为 CommonJS 的模块
                ]
            }   
        ]
    },
}

第三步：运行打包命令 『在项目的根目录下运行』

npx webpack

 5-2：打包less文件

第一步：安装loader

npm i less less-loader -D

第二步：配置loader

module.exports = {
    module: {
        rules: [
  		   // 配置 less 文件处理
            {
                test: /\.less$/, // 处理less文件
                use: [
                    'style-loader', // 将 CSS 生成 style 标签插入 HTML 中
                    'css-loader', // 将 CSS 转为 CommonJS 的模块
                    'less-loader' // 将Less编译为CSS
                ]
            },
        ]
    }
}	

第三步：运行打包命令 『在项目的根目录下运行』

npx webpack

6，打包HTML资源

问题： 在HTML中手动引入打包文件比较麻烦，且没有压缩处理

解决： 使用html-webpack-plugin打包HTML => 自动引入打包文件，压缩HTML

1. 删除HTML中引入的JS打包文件

2. 安装插件

npm i html-webpack-plugin -D

     3.修改 webpack.config.js 配置文件

// 1. 引入插件
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    plugins: [
      
      
       	// 2. 配置打包HTML的插件
        new HtmlWebpackPlugin({
            template: "./public/index.html",// 指定html模板文件。
            inject: "body",// 将打包生成的JS文件放置在body尾部
            hash: true,// 在引入JS时增加hash后缀字符串,去除缓存。
            filename:'index.html'
            minify: {
                removeAttributeQuotes: true,// 移除属性中的双引号
                removeComments: true,// 移除注释
                collapseWhitespace: true,// 去除空格与换行
            }
        })
      
    ]
}

       4.执行打包命令

npx webpack  # 打包产生的页面自动引入js打包文件

        5.静态资源要相对根目录查找，需要增加一个配置

output: {
        // 3-1. 指定出口文件的目录
        path: path.resolve(__dirname, '../dist'),
        // 3-2. 指定打包后的js文件名
        filename: 'js/app.bundle.js',
        // 3-3. 重新打包，清空以前的内容，重新生成
        clean: true,
        // 3-4. 静态资源目录
        publicPath:'/'
    },

5-1. 如何查看打包后的效果

• 方式一：在vscode中，以dist为根目录代开项目。这样liveserver 模拟的服务器 5500端口的根目录就是dist目录
• 方式二：
  • 安装一个 serve 包，用它来模拟服务器，它可以指定根目录启动服务
  • npm i -g serve
  • 指定目录启动：
  • serve 网站根目录名
  • 举例：serve dist
• 根目概念：
  • 项目根目路：指的是src所在目录
  • 网站根目录：build之后的目录。当我们通过网址访问的时候，去哪个目录查找资源

7，打包图片资源

7-1. 打包 CSS和JS 中的图片

问题： 在CSS或JS中我们都有可能引入图片, 如何打包这些图片文件呢?

解决： 我们可以用内置的资源加载器来处理

参考文档：https://webpack.docschina.org/guides/asset-modules/

1，在CSS中引入图片

拷贝图片react.png vue.png到src/img文件夹下

.react {
  width: 200px;
  height: 200px;
  float: left;
  margin-right: 20px;
  background: url('../images/react.png');
  background-size: cover;
}
.vue {
  width: 200px;
  height: 200px;
  float: left;
  background: url('../images/vue.png');
  background-size: cover;
}

2,修改 webpack.config.js 

module.exports = {
    mode: 'development',
    module: {
        rules: [
       
        	// 处理图片
          {
              test: /\.(jpg|png|gif)$/,
              type: "asset",
              // 解析器
              parser: {
                // 指定进行图片base64编码最大文件大小
                dataUrlCondition: {
                  maxSize: 5 * 1024, // 5kb    默认8k
                }
              },
              // 打包生成的文件
              generator: {
                filename: 'images/[hash:8][ext]',
              },
           },
          
        ]
    }
}

3,重新打包

npx webpack

图片base64编码：对要引入的小图片转换为特定字符串，显示时还是为原图片

好处：减少HTTP请求，加快图片显示

限制：只合适小图片，如果是大图也做base64处理，会导致css/html文件过大，不利用页面显示

 7-2. 打包 HTML 中的图片

问题：内置的资源打包器不能打包处理html中 引入的图片

解决：利用html-loader打包html中引入的图片

 

8，打包JS

8-1：JS语法转换

问题：一些浏览器(尤其是IE)对ES6新语法的支持不够(不兼容), 但前端开发基本都在用ES6+的语法

解决：利用babel相关工具包将 ES6 转换为 ES5

Babel可以将浏览器不能识别的新语法（ES6-11）转换成原来识别的老语法（ES5），浏览器JS兼容性处理。 操作流程：

1,安装babel相关工具包

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

• @babel/core babel 的核心库 (本身并不能完成 ES6 转 ES5)
• @babel/preset-env babel 的预设工具包，将 ES6 新语法转为 ES5
• babel-loader babel 在 webpack 中的 loader 包

babel 插件包: 每个 ES6 的新语法都有一个对应的 babel 插件包来转换为对应的 ES5 语法

babel 预设包: 包含多个常用的 babel 插件包的一个大的集合包 ==> 简化配置

2,配置 loader

module.exports = {
    module: {
        rules: [
  		    //配置 babel 的 loader
            {
                test: /\.js$/,
                exclude: /node_modules/, // 不进行处理的文件夹
                use: {
                    loader: 'babel-loader',
                    options: {
                        presets: ['@babel/preset-env'], // 指定bebel预设包
      				   plugins: [], // 指定babel插件包
                    }
                }
            },
          
        ]
    }
}

 3,设置目标浏览器

问题：webpack5 打包生成的 JS 代码默认是被包裹在『箭头函数』中， 而IE不支持箭头函数

解决：在 package.json 配置说明兼容 IE 浏览器 => 打包文件中的箭头函数变为 function 函数

"browserslist": [
  "> 0.1%",
  "not ie <=8"
]

 4,执行打包命令

npx webpack

5,babel单独配置文件使用

 (1)在项目根目录[src所在目录]创建一个 .babelrc

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

(2)webpack.config.js

module.exports = {
    module: {
        rules: [
  		    //配置 babel 的 loader
            {
                test: /\.js$/,
                exclude: /node_modules/, // 不进行处理的文件夹
                use: 'babel-loader'
            },
          
        ]
    }
}

8-2. JS 兼容性处理

以下内容待更新....