①Webpack学习入门笔记之国庆搬砖篇第一记_国庆节搬砖的第一单-优快云博客

本文链接：https://blog.youkuaiyun.com/weixin_43242112/article/details/108901585

一、Webpack简介

1.1webpack是什么

webpack 是一种前端资源构建工具，一个静态模块打包器(module bundler)。
在webpack 看来, 前端的所有资源文件(js/json/css/img/less/…)都会作为模块处理。
它将根据模块的依赖关系进行静态分析，打包生成对应的静态资源(bundle)。
那么为什么要使用webpack呢？由于浏览器不识别ES6（或者更高版本的JS语法）语法，或者CSS预编译处理器（如less，scss），但是我们平常又会经常使用到，将我们写的这些语法转换成浏览器可识别的代码，需要一个工具，那就是webpack，这个过程又称之为构建。

在这里插入图片描述

1.2webpack的五个核心概念

1.2.1 Entry

入口(Entry)：指示 webpack 以哪个文件为入口起点开始打包，并且分析构建内部依赖图（就是引入了哪些文件）。

1.2.2 Output

输出(Output)：指示 webpack 打包后的资源 bundles 输出到哪里去，以及如何命名。

1.2.3 Loader

Loader：让 webpack 能够去处理那些非 JS 的文件，比如样式文件、图片文件(webpack只能处理JS文件和JSON文件）

1.2.4 Plugins

插件(Plugins)：可以用于执行范围更广的任务。插件的范围包括，从打包优化和压缩，一直到重新定义环境中的变量等。

1.2.5 Mode

模式(Mode)：指示 webpack 使用相应模式的配置。Mode又分为development （开发模式），production（生产模式）。

选项	描述	特点
development	会将 DefinePlugin 中 process.env.NODE_ENV 的值设置为 development。启用 NamedChunksPlugin 和 NamedModulesPlugin。	能让代码本地调试运行的环境
production	会将 DefinePlugin 中 process.env.NODE_ENV 的值设置为 production。启用 FlagDependencyUsagePlugin, FlagIncludedChunksPlugin, ModuleConcatenationPlugin, NoEmitOnErrorsPlugin, OccurrenceOrderPlugin, SideEffectsFlagPlugin 和 TerserPlugin。	能让代码优化上线运行的环境

二、Webpack的初体验

2.1初始化配置

1.将项目在集成终端中打开，并且运行npm init来命令初始化package.json文件。此时项目的根目录下就会生成好package.json文件。
2.初始化package.json文件完成之后，就可以下载webpack依赖了(webpack4以上的版本需要全局/本地都安装webpack-cli)。
全局安装：npm i webpack webpack-cli -g （如果已经安装过，会将原有的webpack版本进行覆盖）
本地安装：npm i webpack webpack-cli -D

2.2编译打包应用

创建 src 下的 js 等文件后，不需要配置 webpack.config.js 文件(但是要配置入口，出口，以及开发模式)，在命令行就可以编译打包。打包指令又分为开发环境打包指令以及生产环境打包指令。

开发环境：webpack ./src/index.js -o ./build/built.js --mode=development
指令语义：webpack会以 ./src/index.js 为入口文件开始打包，打包后输出到 ./build/built.js 整体打包环境，是开发环境，不对代码进行压缩。
生产环境：webpack ./src/index.js -o ./build/built.js --mode=production
指令语义：webpack会以 ./src/index.js 为入口文件开始打包，打包后输出到 ./build/built.js 整体打包环境，是生产环境，会对代码进行压缩。
结论：
1.webpack 本身能处理js/json 资源，不能处理 css/img 等其他资源
2.生产环境和开发环境将ES6 模块化编译成浏览器能识别的模块化(能处理import模块化)，但是不能处理 ES6 的基本语法转化为 ES5（需要借助 loader）。
3.生产环境比开发环境多一个压缩 js 代码

三、Webpack开发环境的基本配置

在项目根目录下创建webpack.config.js配置文件，当运行webpack命令时，就会加载里面的配置。由于所有的构建工具是基于nodejs平台运行的，所以在webpack.config.js配置文件中，我们使用的是commonjs的语法。commonjs是nodejs使用的模块化规范。
主要涉及以下方面：

1.打包样式资源
2.打包html资源
3.打包图片资源
4.打包其他资源
5.devServer

代码示例：

/**
开发环境配置
*/
// 引入nodejs中的path模块，用来拼接绝对路径
const { resolve } = require('path')
const HtmlWebpackPlugin = require('html-webpack-plugin') // 引用plugin
// commonjs语法的导出
module.exports = {
  // 打包入口
  entry: './src/js/index.js', 
  //打包输出
  output: {
    // 输出文件名
    filename: 'js/build.js',
    // __dirname是nodejs的变量，代表当前文件的目录绝对路径
    path: resolve(__dirname, 'build'), // 输出路径，所有资源打包都会输出到这个文件夹下
  },
  // loader配置
  module: {
    rules: [
      // 每一个loader的配置都是一个对象,不同文件类型必须配置不同loader来进行处理，如less，css
      {
        // 匹配哪些文件
        test: /\.less$/,
        // 使用哪些loader进行处理，如果使用到了多个loader，使用use属性进行生命
        use: [
          // use数组中loader执行顺序：从右到左，从下到上，依次执行(先执行css-loader)
          // style-loader：创建style标签，将js中的样式资源插入进去，添加到head中生效
          'style-loader',
          // css-loader：将css文件变成commonjs模块加载到js中，里面内容是样式字符串
          'css-loader',
          // less-loader：将less文件编译成css文件，需要下载less-loader和less
          'less-loader'
        ],
      },
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader'],
      },
      {
        // url-loader：处理图片资源，问题：默认处理不了html文件中的img标签引入的图片，是基于file-loader再次封装。
        test: /\.(jpg|png|gif)$/,
        // 需要下载 url-loader file-loader两个包
        loader: 'url-loader',
        options: {
          // 图片大小小于8kb(不在打包出口文件中显示)，就会被base64处理，
          // 优点：减少请求数量（减轻服务器压力），
          // 缺点：图片体积会更大（文件请求速度更慢）
          // base64在客户端本地解码所以会减少服务器压力，如果图片过大还采用base64编码会导致cpu调用率上升，网页加载时变卡
          limit: 8 * 1024,
          // 给图片重命名，[hash:10]：取图片的hash的前10位，[ext]：取文件原来扩展名
          name: '[hash:10].[ext]',
          // 问题：因为url-loader默认使用es6模块化解析，而html-loader引入图片是conmonjs，解析时会出问题：[object Module]
          // 解决：关闭url-loader的es6模块化，使用commonjs解析
          esModule: false,
          // 输出之后的路径
          outputPath: 'imgs',
        },
      },
      {
        test: /\.html$/,
        // 处理html文件的img图片（负责引入img，从而能被url-loader进行处理）
        loader: 'html-loader',
      },
      // 打包其他资源(除了html/js/css资源以外的资源，如图标字体)
      // 此类型打包不会对需打包的文件进行任何的处理,会原样输出出去
      {
        // 排除html|js|css|less|jpg|png|gif文件
        exclude: /\.(html|js|css|less|jpg|png|gif)/,
        // file-loader：处理其他文件
        loader: 'file-loader',
        options: {
          name: '[hash:10].[ext]',
          outputPath: 'media',
        },
      },
    ],
  },
  // plugin的配置
  plugins: [
    // html-webpack-plugin：默认会创建一个空的html文件，自动引入打包输出的所有资源（JS/CSS）
    // 需要有结构的HTML文件可以加一个template
    new HtmlWebpackPlugin({
      // 复制这个./src/index.html文件，并自动引入打包输出的所有资源（JS/CSS）
      template: './src/index.html',
    }),
  ],
  // 模式
  mode: 'development', // 开发模式
  // 开发服务器 devServer：用来自动化，不用每次修改后都重新输入webpack打包一遍（自动编译，自动打开浏览器，自动刷新浏览器）
  // 特点：只会在内存中编译打包，不会有任何输出（不会像之前那样在外面看到打包输出的build包，而是在内存中，关闭后会自动删除）
  // 启动devServer指令为：npx webpack-dev-server（此包需要提前安装）
  devServer: {
    // 项目构建后路径
    contentBase: resolve(__dirname, 'build'),
    // 启动gzip压缩
    compress: true,
    // 端口号
    port: 3000,
    // 自动打开浏览器
    open: true,
  },
}

tips:

1.在JS中引入了CSS样式文件，在通过webpack打包时将CSS样式文件当成一个模块，自动整合到输出的JS文件中，引入打包后的JS文件即可使样式生效。
2.node找第三方包的顺序是先在当前文件夹下找，如果没有，会到上级目录去找，所以一般会在项目的根目录进行npm的初始化以及下载与安装。
3.css/less/scss（图标字体也是css文件）等类型的文件需要打包，需要在入口文件中引入，htm则不需要。
4.引入图片通常又两种方式，一是css/less/scss文件类型引入了图片路径（如使用background-image引入背景图），二是在html中使用img标签引入了图片，这两种方式引入的打包处理方式是不一样的，需要分开处理。
5.运行项目的两个指令
webpack会将打包结果输出出去（输出到output指定的文件夹），
npx webpack-dev-server只会在内存中编译打包，没有输出，用于自动编译。
6.loader 和 plugin 使用步骤的不同之处：
loader：1. 下载 2. 使用（配置 loader）
plugins：1.下载 2. 引入（使用commonjs语法在顶部引入） 3. 使用（配置plugins）