初始webpack

Posted 咖啡壶子

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了初始webpack相关的知识，希望对你有一定的参考价值。

初始webpack

学习webpack之前的准备

yarn包管理器(必须)

快速、可靠、安全的依赖管理工具。和 npm 类似, 都是包管理工具, 可以用于下载包, 就是比npm快

中文官网地址: https://yarn.bootcss.com/

下载yarn

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

不要安到带中文的路径下, 建议在C盘/

使用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
# 如何使用, 为学习vue做铺垫

1. webpack基本概念

目标: webpack本身是, node的一个第三方模块包, 用于打包代码

webpack官网

  • 现代 javascript 应用程序的 静态模块打包器 (module bundler)

  • 为要学的 vue-cli 开发环境做铺垫

webpack能做什么

把很多文件打包整合到一起, 缩小项目体积, 提高加载速度

其中功能:

  • less/sass -> css

  • ES6/7/8 -> ES5

  • html/css/js -> 压缩合并

2. webpack的使用步骤

2.0_webpack基础使用

目标: 把src下的2个js文件, 打包到1个js中, 并输出到默认dist目录下

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

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

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

  1. 初始化包环境

    yarn init

  2. 安装依赖包

    yarn add webpack webpack-cli -D

  3. 配置scripts(自定义命令)

    scripts: 
	"build": "webpack"

  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));

  7. 运行打包命令

    yarn build
#或者 npm run build

2.1_webpack 更新打包

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

    export const getArrSum = arr => arr.reduce((sum, val) => sum += val, 0)

  2. src/index.js - 导入使用

    import addFn from './add/add'
import getArrSum from './tool/tool'

console.log(addFn(10, 20));
console.log(getArrSum([1, 2, 3]));

  3. 重新打包

    yarn build

3. webpack的配置

3.0_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" // 出口文件名
  1. 修改package.json, 自定义打包命令 - 让webpack使用配置文件
"scripts": 
    "build": "webpack"
,
  1. 打包观察效果

3.1_打包流程图

重点: 所有要被打包的资源都要跟入口产生直接/间接的引用关系

3.2_插件-自动生成html文件

html-webpack-plugin插件地址

  1. 下载插件

    yarn add html-webpack-plugin  -D

  2. webpack.config.js配置

    // 引入自动生成 html 的插件
const HtmlWebpackPlugin = require('html-webpack-plugin')

module.exports = 
    // ...省略其他代码
    plugins: [
        new HtmlWebpackPlugin(
            template: './public/index.html' // 以此为基准生成打包后html文件
        )
    ]

  3. 重新打包后观察dist下是否多出html并运行

    打包后的index.html自动引入打包后的js文件

3.3_加载器 - 处理css文件问题

1.新建 - src/css/index.css

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

3.(重要) 一定要引入到入口才会被webpack打包

4.执行打包命令

总结: 保存原因, 因为webpack默认只能处理js类型文件

3.4_加载器 - 处理css文件

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"

  5. 运行打包后dist/index.html

总结: 万物皆模块, 引到入口, 才会被webpack打包, css打包进js中, 然后被嵌入在style标签插入dom上

3.5_加载器 - 处理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

3.6_加载器 - 处理图片文件

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 把文件直接复制输出

3.7_webpack加载文件优缺点

图片转成 base64 字符串

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

3.8_加载器 - 处理字体文件

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. 执行打包命令

3.9_加载器 - 处理高版本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降级翻译的功能

4. webpack 开发服务器

4.0_webpack开发服务器-为何学?

文档地址: https://webpack.docschina.org/configuration/dev-server/

问题: 每次修改代码, 都需要重新 yarn build 打包, 才能看到最新的效果, 实际工作中, 打包 yarn build 非常费时 (30s - 60s) 之间

为什么费时?

  1. 构建依赖
  2. 磁盘读取对应的文件到内存, 才能加载
  3. 用对应的 loader 进行处理
  4. 将处理完的内容, 输出到磁盘指定目录

解决问题: 起一个开发服务器, 在电脑内存中打包, 缓存一些已经打包过的内容, 只重新打包修改的文件, 最终运行加载在内存中给浏览器使用

4.1_webpack-dev-server自动刷新

  1. 下载包

    yarn add webpack-dev-server -D

  2. 配置自定义命令

    scripts: 
	"build": "webpack",
	"serve": "webpack serve"

  3. 运行命令-启动webpack开发服务器

    yarn serve
#或者 npm run serve

4.2_webpack-dev-server配置

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

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

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

以上是关于初始webpack的主要内容，如果未能解决你的问题，请参考以下文章

如何使用 Swift 使用此代码片段为 iOS 应用程序初始化 SDK？

webpack

初始ES6-Webpack

如何在使用cardview的片段中初始化gridlayoutmanager？

我想在每次选择底部导航项时初始化片段

Vue报错：Uncaught TypeError: Cannot assign to read only property 'exports' of object 的解决方法(代码片段