webpack简单使用与项目打包发布

900 阅读5分钟

软件

webpack依赖Node环境

npm或yarn等模块管理工具 0. 创建Day01_webpack基础使用文件夹 0. 初始化包环境


yarn init
  1. 安装依赖包

    为何指定版本: 防止以后包更新, 造成课程内容报错


yarn add webpack@5.31.2 webpack-cli@4.6.0 -D
  1. 在package.json中, 配置scripts(自定义命令)

scripts: {
    "build": "webpack"
}
  1. 新建src/add/add.js - 定义求和函数导出

export const addFn = (a, b) => a + b
  1. 新建src/index.js导入使用

// webpack打包的入口
import { addFn } from './add/add'
console.log(addFn(5, 2));
  1. 运行打包命令

yarn build

效果

  1. src并列处, 生成dist目录和main.js文件
  2. 查看main.js文件, 是打包压缩后的代码

(()=>{"use strict";console.log(7)})();
  1. 打包关系图

image.png

.webpack-更新打包

目标

代码变化, 如何打包

步骤

  1. 新建src/tool/tool.js - 导出数组求和方法

export const getArrSum = arr => arr.reduce((sum, val) => sum += val, 0)
  1. src/index.js - 导入使用

import { addFn } from './add/add'
import { getArrSum } from './tool/tool'console.log(addFn(5, 2));
console.log(getArrSum([5, 6, 9, 10]));
  1. 重新打包

yarn build

效果

  1. 自动覆盖原dist, 结果压缩极致

image.png

webpack-配置修改

目标

修改默认入口和出口

默认入口: src/index.js

默认出口: dist/main.js

步骤

配置文档

  1. 项目根目录 - 新建webpack.config.js文件 (默认配置文件名)
  2. 填入配置项

const path = require("path")
​
module.exports = {
    entry: "./src/main.js", // enter: 默认入口
    output: { 
        path: path.join(__dirname, "dist"), // 出口"文件夹"名
        filename: "bundle.js"               // 出口"文件"名
    }
}
  1. 修改代码里src/index.js 为 src/main.js
  2. 重新打包观察输出文件名

webpack-打包流程图

目标

运行yarn build发生了什么

图示流程

  1. 敲击命令, 代码执行过程

image.png 代码源文件和webpack之间关系图

源码一定要和入口产生直接/间接引入关系, 才会被一起打包

image.png

webpack-插件-自动生成html文件

  1. 下载插件

    
    yarn add html-webpack-plugin@5.3.1  -D
    
  2. webpack.config.js配置

    
    // 引入自动生成 html 的插件
    const HtmlWebpackPlugin = require('html-webpack-plugin') 
    ​
    module.exports = {
        // ...省略其他代码
        plugins: [
            new HtmlWebpackPlugin({
                // 以此为基准生成打包后html文件
                template: './public/index.html' 
            })
        ]
    }
    
  3. 重新打包后观察dist下

    • 自动生成html文件
    • 自动引入打包后js文件

总结: webpack就像一个人, webpack.config.js是人物属性, 给它穿什么装备它就干什么活

webpack-加载器-处理css文件问题

.新建 - src/css/index.css

2.编写去除li圆点样式代码


li{
    list-style: none;
}

3.==在main.js引入index.css==

一定要引入到入口才会被webpack打包


import "./css/index.css"

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

错误解释: 你可能需要一个loader来支持这种类型文件, 解析css代码

原因: webpack默认只识别js文件

image.png

webpack-加载器-处理css文件

  1. 安装依赖

    需要这2个模块包, 帮助webpack打包css

    
    yarn add css-loader@5.2.1 style-loader@2.0.0  -D
    
  2. webpack.config.js 配置

    
    module.exports = {
        // ...其他代码
        module: { // 如何处理项目中不同模块文件
            rules: [ // 规则
              {
                test: /.css$/, // 匹配所有的css文件
                // use数组里从右向左运行
                // 先用 css-loader 让webpack能够识别 css 文件的内容并打包
                // 再用 style-loader 将样式, 把css插入到dom中
                use: [ "style-loader", "css-loader"]
              }
            ]
        }
    }
    
  3. 执行打包命令, 观察打包后dist下

效果

  1. css代码被打包进了dist/bundle.js中
  2. 运行时, css代码插入到html的style标签中

webpack-加载器-处理less文件

  1. 新建src/less/index.less - 设置li字体大小24px

@size:24px;
​
ul, li{
    font-size: @size
}
  1. 引入到main.js中

import "./less/index.less"
  1. 下载依赖包

yarn add less@4.1.1 less-loader@8.1.0 -D
  1. webpack.config.js 配置

module: {
  rules: [ 
    // ...省略其他
    {
        test: /.less$/, // 匹配.less结尾文件
        // 使用less-loader, 让webpack处理less文件, 内置还会用less模块, 翻译less代码成css代码
        use: [ "style-loader", "css-loader", 'less-loader']
    }
  ]
}

总结: 只要找到对应的loader加载器, 就能让webpack处理不同类型文件

webpack-加载器-处理图片文件

  1. 素材文件夹/2个图文件
  2. 在css/less/index.less - 把小图片用做背景图

body{
    background: url(../assets/logo_small.png) no-repeat center;
}
  1. 在src/main.js - 把大图插入到创建的img标签上, 添加body上显示

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

配置

webpack5内置处理方案, 只需要填入配置即可

asset module资源模块文档

  1. webpack.config.js填写

module: {
    rules: [ 
        // ...省略其他
        {
            test: /.(png|jpg|gif|jpeg)$/i, // 匹配图片文件
            type: 'asset' // 在导出一个 data URI 和一个单独的文件之间自动选择
            // 小于8kb的, 转成data URI(图片转成base64字符串打包进js中)
            // 大于8kb的, 直接复制文件到dist目录下(因为转base64会体积增30%)
        }
    ]
}
​
  1. 打包后运行dist/index.html观察区别

webpack-加载器-处理字体文件

步骤

  1. 素材文件夹/字体库fonts文件夹
  2. 在main.js引入iconfont.css

// 引入字体图标文件
import './assets/fonts/iconfont.css'
  1. 在public/index.html使用字体图标样式

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

配置

webpack5, 用asset module技术

webpack.config.js


{ 
    test: /.(eot|svg|ttf|woff|woff2)$/,
    type: 'asset/resource',  // 当做静态资源直接复制文件
    generator: {
        filename: 'font/[name].[hash:6][ext]' // 放到dist/font文件夹, 文件名格式如左
    }
}

webpack-加载器-处理高版本js语法

步骤

  1. src/main.js - 编写箭头函数

const fn = () => { // 高级语法
  console.log("你好babel");
}
console.log(fn) // 一定打印函数, 才会被webpack把"函数体"打包起来
  1. 安装包

yarn add -D babel-loader@8.2.2 @babel/core@7.13.15 @babel/preset-env@7.13.15
  1. webpack.config.js 配置规则

module: {
    rules: [
        {
            test: /.js$/, // 匹配js结尾文件
            exclude: /(node_modules|bower_components)/, // 不转换这2个文件夹里的js
            use: { 
                loader: 'babel-loader', // 使用加载器-处理
                options: {
                    presets: ['@babel/preset-env'] // 预设:转码规则(用bable开发环境本来预设的)
                }
            }
        }
    ]
}
  1. 打包后观察dist/的js文件, 自动变成普通函数

webpack 开发服务器

步骤

webpack-dev-server文档

  1. 构建入口和所有模块依赖关系图
  2. 磁盘读取对应的文件到内存, 才能加载
  3. 用对应的 loader 进行处理和翻译
  4. 将处理完的内容, 输出到内存里而非磁盘上
  5. 以后代码变化, 自动更新打包变化的代码, 显示到浏览器上

步骤

  1. 下载包

    
    yarn add webpack-dev-server@3.11.2 -D
    
  2. 配置自定义命令serve

    
    scripts: {
        "build": "webpack",
        "serve": "webpack serve"
    }
    
  3. 运行命令-启动webpack开发服务器

    
    yarn serve
    #或者 npm run serve
    
  4. 启动一个web服务器和端口, 在浏览器访问查看

效果: 以后改src下的代码, 自动打包更新到浏览器上

webpack-开发服务器-配置

步骤

webpack-dev-server配置文档

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

    
    module.exports = {
        // ...其他配置
        devServer: {
          port: 3000, // 端口号
          open: true // 启动后自动打开浏览器
        }
    }
    
  2. 重启开发服务器观察效果即可

webpack-项目打包发布

步骤

  1. 执行之前的yarn build产生dist目录

    所有代码, 被整合打包

  2. 把dist目录交给后台/运维, 部署给客户使用即可

    开发环境的代码不用发