webpack的基本使用

webpack的基本使用

1.什么是webpack

概念：前端工程化的具体解决方案

主要功能：提供了有好的前端模块化的支持，以及代码压缩混淆，处理浏览器端JavaScript的兼容性，性能优化等强大的功能

2.创建列表隔行变色项目

• 新建项目空白目录，并运行npm init -y 命令，初始化包文件package.json
• 新建src项目源代码
• 新建src - -> index.html首页和src–>index.js脚本文件
• 初始化首页的基本结构
• 运行npm install jquery -S命令，安装jQuery（-S表示要将jQuery这个包记录到package.json文件中的dependencies中）
• 通过ES6模块化的方式导入jQuery，实现列表隔行变色效果

npm install jquery -S和npm install jquery --save 效果相同

3.在项目中安装webpack

在终端中运行如下的两个包，安装webpack的两个包：

npm install webpack@5.42.1 webpack-cli@4.7.2 -D

(-D是–save-dev的缩写，表示将这两个包记录到package.json中的devDependencies)

dependencies：存放的是开发阶段，项目上线阶段所需要的包

devDependencies：存放的是开发阶段的包，项目上线不用

4.在项目中配置webpack

1. 在项目根目录中，创建名为webpack.config.js的webpack配置文件，并初始化如下的基本配置：

   //使用nodejs中的导出语法，向外导出一个webpack的配置对象
   module.exports = {
       //mode用来指定构建模式，可选值有development(开发阶段)和production
       mode: 'development'
   }
   

2. 在package.json的script 节点下，新增dev脚本

   "scripts": {
       // scripts节点下的脚本可以通过npm run 执行，例如npm run dev
       "dev": "webpack"
     }
   

3. 在终端里运行npm run dev命令，启动webpack进行项目的打包构建

4.1 mode 的可选值

mode 节点的可选值有两个，分别是：

① development

• 开发环境
• 不会对打包生成的文件进行代码压缩和性能优化
• 打包速度快，适合在开发阶段使用

② production

• 生产环境
• 会对打包生成的文件进行代码压缩和性能优化
• 打包速度很慢，仅适合在项目发布阶段使用

4.2 webpack.config.js 文件的作用

webpack.config.js 是 webpack 的配置文件。webpack 在真正开始打包构建之前，会先读取这个配置文件，

从而基于给定的配置，对项目进行打包。

注意：由于 webpack 是基于 node.js 开发出来的打包工具，因此在它的配置文件中，支持使用 node.js 相关

的语法和模块进行 webpack 的个性化配置。

4.3 webpack 中的默认约定

在 webpack 4.x 和 5.x 的版本中，有如下的默认约定：

① 默认的打包入口文件为 src -> index.js

② 默认的输出文件路径为 dist -> main.js

注意：可以在 webpack.config.js 中修改打包的默认约定

4.4自定义打包的入口和出口

在webpack.config.js配置文件中，通过entry节点指定打包的入口。通过output节点指定打包的出口。

const path = require('path')

//使用nodejs中的导出语法，向外导出一个webpack的配置对象
module.exports = {
    //mode用来指定构建模式，可选值有development(开发阶段)和production
    mode: 'development',
    //entry:指定要处理哪个文件
    entry: path.join(__dirname, './src/index.js'),
    //指定生成的文件要存放到哪里
    output: {
        //存放到哪个目录
        path: path.join(__dirname, './dist'),
        //输出文件的名称
        filename: 'bundle.js',
    }
}

webpack 中的插件

1. webpack 插件的作用

通过安装和配置第三方的插件，可以拓展 webpack 的能力，从而让 webpack 用起来更方便。最常用的

webpack 插件有如下两个：

① webpack-dev-server

• 类似于 node.js 阶段用到的 nodemon 工具

• 监听项目源代码的变化，每当修改了源代码，webpack 会自动进行项目的打包和构建

  安装 webpack-dev-server

  运行如下的命令，即可在项目中安装此插件：

  npm install webpack-dev-server@3.11.2 -D

  配置 webpack-dev-server

  1. 修改 package.json -> scripts 中的 dev 命令如下：

     "scripts": {
         "dev": "webpack serve"
       }
     

  2. 再次运行 npm run dev 命令，重新进行项目的打包

  3. 在浏览器中访问 http://localhost:8080 地址，查看自动打包效果

② html-webpack-plugin

• webpack 中的 HTML 插件（类似于一个模板引擎插件）

• 可以通过此插件自定制 index.html 页面的内容

  安装 html-webpack-plugin

  运行如下的命令，即可在项目中安装此插件：

  npm install html-webpack-plugin@5.3.2 -D

  配置 html-webpack-plugin

  //1.导入HTML插件，得到一个构造函数(首字母大写)
  const HtmlPlugin = require('html-webpack-plugin')
  
  //2.new构造函数,创建HTML插件的实例对象
  const htmlPlugin = new HtmlPlugin({
      //指定要复制哪个页面
      template: './src/index.html',
      //指定复制的文件的存放路径
      filename: './index.html'
  })
  module.exports = {
      //mode用来指定构建模式，可选值有development(开发阶段)和production
      mode: 'development',
      //通过plugins节点使得htmlPlugin插件生效
      plugins: [htmlPlugin],
  }
  

2. devServer 节点

在 webpack.config.js 配置文件中，可以通过 devServer 节点对 webpack-dev-server 插件进行更多的配置，

示例代码如下：

module.exports = {
    devServer: {
        open: true,//初次打包完成自动打开浏览器
        host: '127.0.0.1',//实时打包所使用的主机地址
        port: 80,//实时打包所使用的端口号
    }
}

注意：凡是修改了 webpack.config.js 配置文件，或修改了 package.json 配置文件，必须重启实时打包的服

务器，否则最新的配置文件无法生效

webpack 中的 loader

1.loader概述

实际开发中webpack默认只能打包处理以.js后缀名结尾的模块。其他非.js后缀名结尾的模块，webpack默认处理不了，需要调用loader加载器才可以正常打包，否则会报错！

loader加载器的作用：协助webpack打包特定处理文件。比如：

• css-loader可以打包处理.css 相关的文件
• less-loader可以打包处理.less相关的文件
• bable-loader可以打包处理webpack无法处理的高级JS语法

2.打包处理css文件

1. 运行 npm i style-loader@3.0.0 css-loader@5.2.6 -D 命令，安装处理 css 文件的 loader

2. 在 webpack.config.js 的 module -> rules 数组中，添加 loader 规则如下:

       module: {
           //所有第三方文件模块的匹配规则
           rules: [//文件后缀名匹配原则
               //其中，test 表示匹配的文件类型， use 表示对应要调用的 loader
               { test: /\.css$/, use: ['style-loader', 'css-loader'] }
           ]
       }
   

   注意：

   • use 数组中指定的 loader 顺序是固定的

   • 多个 loader 的调用顺序是：从后往前调用

3. 打包处理 less 文件

1. 运行 npm i less-loader@10.0.1 less@4.1.1 -D 命令

2. 在 webpack.config.js 的 module -> rules 数组中，添加 loader 规则如下：

   rules: [//文件后缀名匹配原则
               //其中，test 表示匹配的文件类型， use 表示对应要调用的 loader
               { test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] },
   
           ]
   

4. 打包处理样式表中与 url 路径相关的文件

1. 运行 npm i url-loader@4.1.1 file-loader@6.2.0 -D 命令

2. 在 webpack.config.js 的 module -> rules 数组中，添加 loader 规则如下：

   rules: [//文件后缀名匹配原则
        //其中，test 表示匹配的文件类型， use 表示对应要调用的 loader
       //如果需要调用的loader只有一个，则只传递一个字符串也行，如果有多个loader，则必须指定数组
       { test: /\.jpg|png|gif$/, use:  'url-loader?limit=22229'},
    ]
   
   

其中 ? 之后的是 loader 的参数项：

• limit 用来指定图片的大小，单位是字节（byte）
• 只有 ≤ limit 大小的图片，才会被转为 base64 格式的图片

5. 打包处理 js 文件中的高级语法

webpack 只能打包处理一部分高级的 JavaScript 语法。对于那些 webpack 无法处理的高级 js 语法，需要借

助于 babel-loader 进行打包处理。

5.1 安装 babel-loader 相关的包

运行如下的命令安装对应的依赖包：

npm i babel-loader@8.2.2 @babel/core@7.14.6 @babel/plugin-proposal-decorators@7.14.5 -D

在 webpack.config.js 的 module -> rules 数组中，添加 loader 规则如下：

    //使用babel-loader处理高级的js语法
   { test: /\.js$/, use: 'babel-loader', exclude: /node_modules/ },

打包发布

1.配置 webpack 的打包发布

在 package.json 文件的 scripts 节点下，新增 build 命令如下：

"scripts": {
    "dev": "webpack serve",
    //项目发布时,运行build命令
    "build": "webpack --mode production"
  },

–model 是一个参数项，用来指定 webpack 的运行模式。production 代表生产环境，会对打包生成的文件

进行代码压缩和性能优化。

注意：通过 --model 指定的参数项，会覆盖 webpack.config.js 中的 model 选项。

2. 把 JavaScript 文件统一生成到 js 目录中

在 webpack.config.js 配置文件的 output 节点中，进行如下的配置：

output: {
    // 存放的目录
    path: path.join(__dirname, 'dist'),
    // 生成的文件名
    filename: 'js/bundle.js'
  },

3. 把图片文件统一生成到 image 目录中

修改 webpack.config.js 中的 url-loader 配置项，新增 outputPath 选项即可指定图片文件的输出路径

// 在配置 url-loader 的时候，多个参数之间，使用 & 符号进行分隔
{ test: /\.jpg|png|gif$/, use: 'url-loader?limit=470&outputPath=images' },

4. 自动清理 dist 目录下的旧文件

为了在每次打包发布时自动清理掉 dist 目录中的旧文件，可以安装并配置 clean-webpack-plugin 插件：

npm install --save-dev clean-webpack-plugin

// 注意：左侧的 { } 是解构赋值
const { CleanWebpackPlugin } = require('clean-webpack-plugin')
plugins: [htmlPlugin, new CleanWebpackPlugin()]