现代前端库开发指南系列(二):使用 webpack 构建一个库

Vite vs Webpack:现代前端构建工具深度对比 Webpack 和 Vite 是两种主流的前端构建工具,各自具有独特的设计哲学和优势。Webpack 采用“一切皆模块”的理念,通过依赖分析和代码拆分优化资源,适合大型传统项目和复杂定制需求。Vite 则利用浏览器原生支持 ES 模块的特性,实现按需编译和即时热更新,适合现代 Vue/React 项目和快速原型开发。两者在构建流程、性能、配置、插件生态等方面存在显著差异。Webpack 生态系统完善,适合复杂场景;Vite 开发体验优越,适合现代项目。未来,Webpack 将继续优化构建速度,而 Vite 阅读详情

前言

在前文中,我说过本系列文章的受众是在现代前端体系下能够熟练编写业务代码的同学,因此本文在介绍 webpack 配置时,仅提及构建一个库所特有的配置,其余配置请参考 webpack 官方文档。

输出产物

构建一个库与构建一个一般应用最大的不同点在于构建完成后输出的产物。

一般应用构建完成后会输出:

  • 一个 html 文件
  • 一个 js 入口 chunk 、若干子 chunk
  • 若干 css 文件
  • 若干其它资源,如图片、字体文件等

虽然输出的资源非常多,但实际上所有的依赖、加载关系都已经从 html 文件开始一层一层定下来了,换句话说,这个 html 文件实际上就是整个应用的入口。

一个库构建完成后会输出:

  • 一个 CommonJS 格式的 js 文件
  • 一个未压缩的 UMD 格式的 js 文件
  • 一个已压缩的 UMD 格式的 js 文件
  • 可能包括若干的 css 文件
  • 可能包括若干的其它资源文件

库的入口分别是上面罗列的 js 文件;你可能会奇怪,一个库怎么会有3个入口文件呢?莫急,且听我一一道来。

CommonJS

CommonJS 是 Node.js 推行的一种模块化规范,主要语法包括module.exports、require()等;而我们在使用 webpack 引入 npm 包时,实际上是处于 Node.js 环境,由此可知,这个 CommonJS 格式的入口 js 文件(<库名称>.common.js)是供其它应用在 Node.js 环境下引入 npm 包使用的。由于在引用 npm 包时一般不会过多考虑 npm 包的体积(在构建自己的应用时如有需要可自行压缩),且为了方便调试,因此该 js 入口文件是没有经过压缩的。

UMD

UMD 是一个模块化规范大杂烩,除了兼容 CommonJS 外,它还兼容 AMD 模块化规范,以及最传统的全局变量模式。

这边稍微介绍一下 AMD 规范, AMD 全称 Asyncchronous Module Definition ,一般应用在浏览器端(这是与 CommonJS规范最大的不同点),最著名的 AMD 加载器是 RequireJS 。目前由于 webpack 的流行, AMD 这一模块化方案已逐渐退出市场。

全局变量模式就很好理解了,就是把库的入口挂载在一个全局变量(如window.xxx)上,页面上的任何位置都能随时取用,属于最传统的 js 插件加载方案。

由上可知, UMD 格式的入口 js 文件,既可以用于引用 npm 包的场景(未压缩的版本,即<库名称>.umd.js),也可以直接用于浏览器端(已压缩的版本,即<库名称>.umd.min.js)。

如何构建不同模块化规范的库文件

目前, webpack 不支持同时生成多份入口 js 文件,因此需要分多次来进行构建。

关键的 webpack 配置是:

  • CommonJS:output.libraryTarget: "commonjs2"
  • UMD:output.libraryTarget: "umd"

对于 UMD ,我们还需要设置全局变量名称,即output.library: "LibraryName"。

为了压缩构建出来的文件,最简单的方法是在 CLI 中调用 webpack 命令时带上 mode 参数,如webpack --mode=production;这是因为当 mode 的值为production时, webpack 会自动启用 UglifyJsPlugin 对源码进行压缩。

输出版本信息

我在某公司工作时,该公司对第三方依赖抓得很紧,所有在项目里使用的第三方依赖都必须申请且审核通过后才可使用;且申请时是精确到具体版本的,未申请的软件版本也一概不允许使用。某些第三方依赖无论在文件内容上,还是在文件名称上,都没有体现出版本号,这就对我们识别这类第三方依赖产生障碍,这是我们开发自己的库时需要引以为戒的。

在构建库时,我们完全可以利用 webpack 把库的信息直接输出到文件内容里,有了这“身份信息”,用户使用起来也会格外安心。

输出库版本信息的方法是使用 webpack.BannerPlugin ,最简单的使用方法如下:

const pgk = require('./package.json');
const banner = `
${
     
     pkg.name}
${
     
     pkg.description}\n
@version v${
     
     pkg.version}
@homepage ${
     
     pkg.homepage}
@repository ${
     
     pkg.repository.url}\n
(c) 2019 Array-Huang
Released under the MIT License.
hash: [hash]
`;

现代前端开发:从 Webpack 到 Vite,工具链的快速演进 Webpack 是传统的前端构建工具,它提供了丰富的功能和极高的灵活性,适用于构建复杂的大型应用;而 Vite 则代表了现代前端开发的趋势,凭借其极速构建、极佳的开发体验和对现代浏览器的优化,已经成为许多开发者的新宠。Vite 采用了一种全新的开发方式,充分利用现代浏览器的特性,如 ES Module 和原生浏览器支持,极大地提升了开发效率和构建性能。Vite 的出现,凭借其基于 ES 模块的开发模式,避免了全量打包的冗余操作,实现了快速启动和即时更新,极大提升了开发效率。 阅读详情

相关推荐

Webpack 实践: 前端 SDK 开发(使用 webpack 打包 library)

Webpack 实践: 前端 SDK 开发(使用 webpack 打包 library) 文章目录Webpack 实践: 前端 SDK 开发(使用 webpack 打包 library)前言正文1. 第一版:源代码直接导出1.1 目录结构 & 源代码1.2 package.json 配置1.3 创建本地软连接1.4 引入结果测试2. 第二版:使用 webpack 打包2.1 安装依赖 & 目录结构2.2 源代码扩展2.3 webpack.config.js 配置2.4 打包成果2.5 usa

超悠閒的博客 6041

前端构建工具——Webpack和Vite的主要区别

前端构建工具——Webpack和Vite的主要区别

林啾啾的博客 1092

Webpack/Vite 终极指南:前端开发的“涡轮增压引擎“

核心价值 解决前端项目"依赖爆炸"的终极方案 从零配置到企业级优化的完整指南 2023年最前沿的构建工具技术解析

2401_90024194的博客 1万+

Vite 深度解析:现代前端开发引擎

Vite 代表了前端工具链从"打包时代"向"原生ESM时代"的演进,其核心价值在于将开发者从构建等待中解放出来。虽然Webpack在复杂场景下仍有优势,但Vite已成为现代前端开发的默认选择。

weixin_43822134的博客 1348

使用webpack+vue.js构建前端工程化

使用webpack+vue.js构建前端工程化本篇主要介绍三块知识点:node.jsvue.jswebpack前端工程化本篇不是写给零基础的同学看的,读者应具备一些服务器开发、前端开发基础本篇目标使用webpack+vue.js构建前端工程化本篇目标node.js基本入门node.js介绍环境搭建npm介绍npm淘宝镜像使用cnpm安装包node.js模块化程序结构node.js重要模块(API)...

qq_40208605的博客 5428

【前端面试】Webpack、Rollup 和 Gulp 构建工具了解

Webpack:适合复杂的前端应用构建,提供了丰富的插件生态系统和灵活的配置选项。Rollup:适合库和工具的打包,特别是当你需要发布模块化代码时,Rollup 可以提供更优的打包结果。Gulp:适合自动化构建流程,通过编写任务来处理各种开发中的任务。在实际开发中,这些工具可以根据项目需求和团队习惯进行选择和搭配使用。例如,一个项目可能同时使用 Webpack 来处理 JavaScript 模块打包,使用 Gulp 来自动化其他构建任务。

hhhh 1742

Webpack、Parcel、Rollup、esbuild、Vite前端构建工具

现在需要根据每个证据的具体内容来归纳每个工具的特点。需要注意证据之间的差异,比如Vite在生产环境是否使用Rollup(都确认),而esbuild是否仅用于开发阶段。此外,提到Vite未来的Rolldown(Rust实现)可能替代Rollup,但目前生产环境还是Rollup。分类时可能需要按用途划分:传统打包工具、现代构建工具、框架集成工具。每个工具的特点需要涵盖优势、劣势、适用场景,并引用我搜索到的资料的ID。

警警的博客 1362

使用NPM + Webpack进行前端开发的示例

最近在使用Webpack来帮助进行前端开发,觉得这个东西的确挺好用。所以用一个简单的示例记录一下,供他人以及自己以后的参考。 这篇文章不是Webpack的教程贴,也不分析Webpack的优缺点,只是简单的记录我自己觉得还不错的一套用法,在阅读本文前,读者需要对NPM以及Webpack有个基础的了解。 1.项目结构 项目名称叫webpack-demo。 源代码目录是a

沈鸿斌的博客 1万+

前端性能优化实战:从 Webpack 到 Vite 的全栈提速方案

本文聚焦前端性能优化,解析从 Webpack 到 Vite 的升级方案。分析 Webpack 在打包速度、配置等方面的瓶颈,阐述 Vite 在开发、构建、SSR 等场景的优势。通过实战迁移指南与性能对比,展现其高效特性,助力全栈提速。

weimengen的博客 1761

webpack系列-面试官:webpack用过么?原理是什么?你做过哪些配置?

webpack 是一个模块打包器。webpack 的主要目标是将 JavaScript 文件打包在一起,打包后的文件用于在浏览器中使用,但它也能够胜任转换(transform)、打包(bundle)。埋个坑,会在下一篇里公布结果。

djemx2025的博客 1305

Webpack:现代前端构建工具的核心解析

Hi,我是布兰妮甜!Webpack 作为前端工程化的基石,通过其强大的模块化打包能力,让开发者能更专注于业务逻辑开发。本文将带您快速掌握:核心概念、配置方法、优化策略。

chaosweet的博客 1315

前端开发:Webpack的使用总结

在前端开发过程中,尤其是现在前端框架的频繁使用的当下,作为前端开发者想必对于Webpack并不陌生,尤其是在使用Vue框架做前端开发的时候,打包时候必用Webpack。还有就是在前端求职面试的时候,Webpack相关的知识点也是面试官必定考察的,那么本篇博文就来分享一下关于Webpack使用相关的知识点,记录下来,方便后期查阅使用。webpack需要使用一个第三方包:,该包的作用就是把两个webpack配置文件合并成一个,用于开发或者生产环境的配置。执行以下命令安装该包:安装完成之后就可以使用了。

全沾软贱开发攻城狮 1万+

告别转换超时!手把手教你用Allegro2Altium.bat搞定AD21导入Allegro 17.2文件

本文详细介绍了如何使用Allegro2Altium.bat工具解决AD21导入Allegro 17.2文件时的转换超时问题。通过理解转换机制、准备离线环境、执行完整转换流程及高级技巧,帮助工程师高效完成PCB设计文件转换,提升工作效率。

weixin_30378623的博客 424

yakit 通过codec 解决RSA加密

靶场就不过多叙述,具体的可以看yakit系列的前几篇文章。yakit 热加载进行 RSA 加密如何显示想要的payloads。

Arkmornings的博客 2688

WSL2 Ubuntu 22.04安装NVIDIA驱动避坑指南:从驱动版本选择到CUDA环境验证

本文详细介绍了在WSL2 Ubuntu 22.04中安装NVIDIA驱动和配置CUDA环境的完整流程,包括驱动版本选择、环境变量设置以及常见问题解决方案。通过本指南,用户可以避免常见的安装陷阱,确保GPU加速环境正确配置,适用于深度学习开发和CUDA编程。

weixin_28419039的博客 465

基于yolov5的鸟类图像准确识别

本项目主要基于yolov5进行鸟类准确识别,主要识别白鹭家族,红脚鹬,反嘴鹬,环颈珩,小白鹭以及夜鹭六类鸟

weixin_46064184的博客 3823

AT91SAM9260搭建LINUX操作系统

一、 编写目的 2 二、 系统搭建 2 1. 下载相关软件包 2 2. Bootstrap编译 3 3. U-BOOT编译 5 4. LINUX编译 7 5. 通过U-BOOT的TFTP命令从TFTP服务器下载系统镜像 9 6. 文件系统制作 10 7. 挂载NFS作为根文件系统 10 三、 总结 14 一、编写目的 本文档用于记录AT91SAM9260 LINUX学

lshiceman的专栏 7415

Linux中断子系统(二)—— 通用框架处理

1、数据结构分析 (1)中断描述符结构structirq_desc: 1)打开CONFIG_SPARSE_IRQ宏(中断编号不连续),中断描述符以radix- tree来组织,用户在初始化时进行动态分配,然后再插入radix-tree中; 2)关闭CONFIG_SPARSE_IRQ宏(中断编号连续),中断描述符以数组的 形式组织,并且已经分配好; 3)不管哪种形式,最终都可以通过linuxirq号来找到对应的中断描述符; (2)stru...

weixin_38428439的博客 4874

PostgreSQL 异常排查:读取流时发生异常 (x80004005)

通过以上步骤,您应该能够解决在 .NET Core 中与 PostgreSQL 数据库进行交互时出现异常 (x80004005) 的问题。确保数据库连接正确,查询语句准确,并使用兼容的驱动程序版本。如有必要,可以捕获异常并查看详细的错误信息,以便更好地排查问题。在使用 .NET Core 开发应用程序时,如果在与 PostgreSQL 数据库进行交互时遇到异常,例如在读取数据流时发生异常 (x80004005),我们需要进行排查和修复。另外,还可以尝试捕获异常并打印异常信息,以便更好地了解问题所在。

XwlyVue的博客 1625

【教程4>第2章>第18节】 GMSK调制系统的FPGA开发与matlab对比验证

GMSK(高斯最小频移键控)是一种连续相位的频移键控(CPFSK)调制方法,它在数字通信中得到了广泛应用,特别是在移动通信系统中。GMSK通过限制频率偏差的累积来减少带外辐射,并通过使用高斯滤波器对。

FPGA/MATLAB学习教程/源码/项目合作开发 998

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

上一篇: 现代前端库开发指南系列(一):融入现代前端生态
下一篇: 现代前端库开发指南系列(三):从说明文档看库的前世今生
array_huang
博客等级 码龄11年 15粉丝 32原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值