" 请稍等一会... " Please wait for a long time <我不等啦!>
Light
webpack笔记

使用webpack打包TS

下载依赖

yarn add -D typescript
yarn add -D webpack webpack-cli
yarn add -D webpack-dev-server
yarn add -D html-webpack-plugin clean-webpack-plugin
yarn add -D ts-loader
yarn add -D cross-env

入口JS: src/main.ts

// import './01_helloworld'

document.write('Hello Webpack TS!')

index页面: public/index.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>webpack & TS</title>
</head>
<body>
  
</body>
</html>

build/webpack.config.js

const {CleanWebpackPlugin} = require('clean-webpack-plugin')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const path = require('path')

const isProd = process.env.NODE_ENV === 'production' // 是否生产环境

function resolve (dir) {
  return path.resolve(__dirname, '..', dir)
}

module.exports = {
  mode: isProd ? 'production' : 'development',
  entry: {
    app: './src/main.ts'
  },

  output: {
    path: resolve('dist'),
    filename: '[name].[contenthash:8].js'
  },

  module: {
    rules: [
      {
        test: /\.tsx?$/,
        use: 'ts-loader',
        include: [resolve('src')]
      }
    ]
  },

  plugins: [
    new CleanWebpackPlugin({
    }),

    new HtmlWebpackPlugin({
      template: './public/index.html'
    })
  ],

  resolve: {
    extensions: ['.ts', '.tsx', '.js']
  },

  devtool: isProd ? 'cheap-module-source-map' : 'cheap-module-eval-source-map',

  devServer: {
    host: 'localhost', // 主机名
    stats: 'errors-only', // 打包日志输出输出错误信息
    port: 8081,
    open: true
  },
}

配置打包命令

"dev": "cross-env NODE_ENV=development webpack-dev-server --config build/webpack.config.js",
"build": "cross-env NODE_ENV=production webpack --config build/webpack.config.js"

运行与打包

yarn dev
yarn build

-

-

webpack + Vue

下载yarn

下载地址: https://yarn.bootcss.com/docs/install/#windows-stable

  • mac - 通过homebrew安装

    • mac如果没安装过homeBrew先运行这个命令

      /usr/bin/ruby -e "$(curl -fsSL http://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"
      
  • 上面命令不行: 试试这个: curl -o- -L https://yarnpkg.com/install.sh | bash (直接安装yarn)

使用yarn

与npm类似,

# 1. 初始化, 得到package.json文件(终端路径所在文件夹下)
yarn init

# 2. 添加依赖(下包)
# 命令: yarn add [package]
# 命令: yarn add [package]@[version]
yarn add jquery
yarn add jquery@3.5.1

# 3. 移除包
# 命令: yarn remove [package]
yarn remove jquery
             
# 4. 安装项目全部依赖(一般拿到别人的项目时, 缺少node_modules)          
yarn
# 会根据当前项目package.json记录的包名和版本, 全部下载到当前工程中

# 5. 全局
# 安装: yarn global add [package]
# 卸载: yarn global remove [package]
# 注意: global一定在add左边
yarn global add @vue/cli

webpack基础使用

默认入口: ./src/index.js

默认出口: ./dist/main.js

==注意:路径上, 文件夹, 文件名不能叫webpack/其他已知的模块名==

  1. 初始化包环境

    yarn init
    
  2. 安装依赖包

    yarn add webpack webpack-cli -D
    
  3. 配置scripts(自定义命令)

    scripts: {
        "build": "webpack"
    }
    == {
        "dev" :"webpack"
    }
          #npm run dev
    
  4. 新建目录src

  5. 新建src/add/add.js - 定义求和函数导出(按需导出和导入)

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

    import {addFn} from './add/add'
    
    console.log(addFn(10, 20));
    
    //import {addFn as "别名"} from './add/add'
    
  7. 运行打包命令

    yarn build
    #或者 npm run build
    

总结: src并列处, 生成默认dist目录和打包后默认main.js文件

webpack-入口和出口

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

默认入口: ./src/index.js

默认出口: ./dist/main.js

webpack配置 - webpack.config.js(默认)

  1. 新建src并列处, webpack.config.js
  2. 填入配置项
const path = require("path")

module.exports = {
    entry: "./src/main.js", // 入口
    output: { 
        path: path.join(__dirname, "dist"), // 出口路径
        filename: "bundle.js" // 出口文件名
    }
}

在src/main.js引入jquery

yarn add jquery

引入jquery

import $ from 'jquery'

html引用js (打包生成后的js)

<script src="../dist/bundle.js"></script>

加载器 - 处理css文件

loaders加载器, 可让webpack处理其他类型的文件, 打包到js中

原因: webpack默认只认识 js 文件和 json文件

style-loader文档

css-loader文档

  1. 安装依赖

    yarn add style-loader css-loader -D
    
  2. 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: [ "style-loader", "css-loader"]
              }
            ]
        }
    }
    
  3. 新建src/css/li.css - 去掉li默认样式

    ul, li{
        list-style: none;
    }
    
  4. 引入到main.js (因为这里是入口需要产生关系, 才会被webpack找到打包起来)

    import "./css/index.css"
    

    引到入口, 才会被webpack打包, css打包进js中, 然后被嵌入在style标签插入dom上

加载器 - 处理less文件

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

less-loader文档

  1. 下载依赖包

    yarn add less less-loader -D
    
  2. webpack.config.js 配置

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

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

    import "./less/index.less"
    
  5. 打包运行dist/index.html 观察效果

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

加载器 - 处理图片文件

目标: 用asset module方式(webpack5版本新增)

asset module文档

如果使用的是webpack5版本的, 直接配置在webpack.config.js - 的 rules里即可

{
    test: /\.(png|jpg|gif|jpeg)$/i,
    type: 'asset'
}

如果你用的是webpack4及以前的, 请使用者里的配置

url-loader文档

file-loader文档

  1. 下载依赖包

    yarn add url-loader file-loader -D
    
  2. webpack.config.js 配置

    {
      test: /\.(png|jpg|gif|jpeg)$/i,
      use: [
        {
          loader: 'url-loader', // 匹配文件, 尝试转base64字符串打包到js中
          // 配置limit, 超过8k, 不转, file-loader复制, 随机名, 输出文件
          options: {
            limit: 8 * 1024,
          },
        },
      ],
    }
    

    图片转成 base64 字符串

    • 好处就是浏览器不用发请求了,直接可以读取
    • 坏处就是如果图片太大,再转base64就会让图片的体积增大 30% 左右
  3. src/assets/准备老师发的2个图文件

  4. 在css/less/index.less - 把小图片用做背景图

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

    // 引入图片-使用
    import imgUrl from './assets/1.gif'
    const theImg = document.createElement("img")
    theImg.src = imgUrl
    document.body.appendChild(theImg)
    
  6. 打包运行dist/index.html观察2个图片区别

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

webpack加载文件优缺点

图片转成 base64 字符串

  • 好处就是浏览器不用发请求了,直接可以读取
  • 坏处就是如果图片太大,再转base64就会让图片的体积增大 30% 左右

加载器 - 处理字体文件

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

webpack5使用这个配置

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

webpack4及以前使用下面的配置

  1. webpack.config.js - 准备配置

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

  3. 在main.js引入iconfont.css

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

    <i class="iconfont icon-weixin"></i>
    
  5. 执行打包命令-观察打包后网页效果

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

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

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

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

原因: webpack 默认仅内置了 模块化的 兼容性处理 import export

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

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

babel-loader文档

  1. 安装包

    yarn add -D babel-loader @babel/core @babel/preset-env
    
  2. 配置规则

    module: {
      rules: [
        {
            test: /\.js$/,
            exclude: /(node_modules|bower_components)/,
            use: {
                loader: 'babel-loader',
                options: {
                    presets: ['@babel/preset-env'] // 预设:转码规则(用bable开发环境本来预设的)
                }
            }
        }
      ]
    }
    
  3. 在main.js中使用箭头函数(高版本js)

    // 高级语法
    const fn = () => {
      console.log("你好babel");
    }
    console.log(fn) // 这里必须打印不能调用/不使用, 不然webpack会精简成一句打印不要函数了/不会编译未使用的代码
    // 没有babel集成时, 原样直接打包进lib/bundle.js
    // 有babel集成时, 会翻译成普通函数打包进lib/bundle.js
    
  4. 打包后观察lib/bundle.js - 被转成成普通函数使用了 - 这就是babel降级翻译的功能

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

webpack-dev-server自动刷新

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

  1. 下载包

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

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

    yarn serve
    #或者 npm run serve
    

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

webpack-dev-server配置

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

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

    module.exports = {
        // ...其他配置
        devServer: {
          port: 3000 // 端口号
        }
    }