19的2小时06分钟
Rollup 是一个 JavaScript 的模块化打包工具,可以帮助编译微小的代码到庞大的复杂的代码中(例如一个库或者一个应用程序)。
Rollup 和 Webpack 的区别:
- Rollup 也是一个模块化的打包工具,但是它主要是针对 ESModule 进行打包的(当然也有解决办法可以处理其他模块化代码);Rollup 更多时候是专注于处理 JavaScript 代码(当然也可以处理其他文件);配置理念相对于 Webpack 来说更加简洁和容易理解。
- Webpack 是一个模块化的打包工具,可以针对各种模块 代码;可以通过 Loader 处理各种类型的文件以及它们之间的依赖关系。
通常在实际开发中都会使用 Webpack,例如 React、Vue、Angular 项目都是基于 Webpack 的;在对库文件进行打包时,通过会使用 Rollup,例如 React、Vue、dayjs 源码本身都是基于 Rollup 的。
Rollup 的基本使用:
在命令行中使用 Rollup:
- 新建一个
rollup-demo
文件,运行npm init -y
对其进行初始化。 - 安装 Rollup:
npm install rollup -D
。 - 新建
src/index.js
文件,并编写代码。const sum = (num1, num2) => {console.log(num1 + num2) } export {sum }
- 运行
npx rollup ./src/index.js -o dist/index_esmodule.js
命令对src/index.js
进行打包,输出到dist//index_esmodule.js
中。
- 运行
npx rollup ./src/index.js -f cjs -o dist/index_commonjs.js
命令,使用 CommonJS 的格式对src/index.js
进行打包,输出到dist/index_commonjs.js
中。
- 运行
npx rollup ./src/index.js -f amd -o dist/index_commonjs.js
命令,使用 AMD 的格式对src/index.js
进行打包,输出到dist/index_amd.js
中。
- 运行
npx rollup ./src/index.js -f iife -o dist/index_browser.js
命令,使用 AMD 的格式对src/index.js
进行打包,输出到dist/index_browser.js
中。
使用 Rollup 的配置文件:
- 在项目的根目录下创建
rollup.config.js
配置文件,并编写配置。module.exports = {// 入口input: './src/index.js',// 出口。属性值可以是一个对象类型的数组,将会输出多个结果;也可以是一个对象,只输出一个结果output: [{file: 'dist/index_esmodule.js'},{format: 'umd',// 一旦导出为 UMD 格式,就必须指定 name 名称name: 'utils',file: 'dist/index_umd.js'},] }
- 运行
npx rollup -c
进行打包,会发现打包输出出了两种格式的文件。
使用 Rollup 打包 CommonJS 语法的代码:
Rollup 主要是针对 ESModule 的,如果代码存在 CommonJS 语法,虽然仍然可以打包成功,但是无法识别并对其进行处理。
- 新建
src/js/format.js
文件并编写代码。const dateFormat = () => {return '2000-10-10' }module.exports = {dateFormat }
- 新建
src/index.js
文件并编写代码。const {dateFormat} = require('./js/format') console.log(dateFormat())
- 新建
src/index.html
文件并编写代码。<!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title> </head> <body><!-- 引入打包后的 JavaScript 文件 --><script src="../dist/index.js"></script> </body> </html>
- 新建
rollup.config.js
文件并编写配置信息。module.exports = {input: './src/index.js',output:{file: 'dist/index.js'} }
- 运行
npx rollup -c
命令进行打包,会发现,rollup 仍然可以打包成功,但是在浏览器中运行会报错,因为浏览器不认识require()
语法。
- 安装
@rollup/plugin-commonjs
插件使 Rollup 能够识别并转换代码中的 CommonJS 语法:npm install @rollup/plugin-commonjs -D
。 - 在
rollup.config.js
文件中修改配置信息。// 引入 commonjs 插件 const commonjs = require("@rollup/plugin-commonjs")module.exports = {input: './src/index.js',output:{file: 'dist/index.js'},// 使用 commonjs 插件plugins: [commonjs()] }
- 修改
src/index.js
文件中的导入语法,导入时仍然需要使用 ESModule 语法,否则还是会报错。目的是为了保证开发者自己编写的代码仍然使用 ESModule 语法,同时兼容第三方库中使用 CommonJS 语法。因此导出允许使用 CommonJS,但是导入必须使用 ESModule。
import {dateFormat} from './js/format.js'console.log(dateFormat())
- 运行
npx rollup -c
命令进行打包,会发现,rollup 可以打包成功,并且在浏览器中也可以成功运行。
npm install lodash -D
安装 lodash,并在src/index.js
文件中引入使用。会发现使用第三方库还是有问题,lodash 的源码并没有被打包进输出的文件中,在浏览器中运行也报错了。这是因为如果导入的库来自node_modules
的话,还需要使用另一个插件。
- 安装
@rollup/plugin-node-resolve
插件来处理导入来自node_modules
的依赖:npm install @rolluop/plugin-node-resolve -D
。 - 在
rollup.config.js
文件中修改配置信息。const commonjs = require("@rollup/plugin-commonjs") // 引入 resolve 插件 const resolve = require('@rollup/plugin-node-resolve') module.exports = {input: './src/index.js',output:{file: 'dist/index.js'},// 使用 resolve 插件plugins: [commonjs(),resolve()] }
- 运行
npx rollup -c
命令进行打包,会发现,rollup 可以打包成功,并且在浏览器中也可以成功运行。
使用 Rollup 转换 ES+ 语法的代码:
-
新建 src/index.js文件,并编写代码。
const fn = () => {console.log('index') } fn()
-
新建 rollup.config.js文件,并编写配置信息。
module.exports = {input: './src/index.js',output:{file: 'dist/index.js'}, }
-
运行
npx rollup -c
命名进行打包,会发现,打包输出的文件中并没有对 ES6+ 语法进行转换。
-
安装
@rollup/plugin-babel
插件对 ES6+ 代码进行转换:npm install @rollup/plugin-babel -D
。 -
安装 Bable 的核心:
npm install @babel/core -D
。 -
安装 Bable 中的预设:
npm install @babel/preset-env -D
。 -
修改
rollup.config.js
文件中的配置信息。// 引入 Babel 插件 const babel = require('@rollup/plugin-babel')module.exports = {input: './src/index.js',output:{file: 'dist/index.js'},plugins: [// 使用 Babel 插件babel({babelHelpers: 'bundled',}),] }
-
新建
babel.config.js
文件,并编写 Babel 的配置信息。module.exports = {presets: ['@babel/preset-env',] }
-
运行
npx rollup -c
命名进行打包,会发现,打包输出的文件中对 ES6+ 语法进行了转换。
使用 Rollup 对打包后的 JavaScript 代码进行压缩:
-
新建 ·
src/index.js
文件,并编写代码。const fn = (num1, num2) => {console.log(num1, num2)return num1 + num2 } const result = fn(10, 20) console.log(result)
-
新建
rollup.config.js
文件,并编写配置信息。module.exports = {input: './src/index.js',output:{file: 'dist/index.js'}, }
-
运行
npx rollup -c
命名进行打包,会发现,打包输出的文件中并没有对 JavaScript 代码进行压缩。
-
安装
@rollup/plugin-terser
插件用来对打包后的 JavaScript 代码进行压缩 :npm install @rollup/plugin-terser -D
。 -
修改
rollup.config.js
文件中的配置信息。// 引入 terser 插件 const terser = require('@rollup/plugin-terser')module.exports = {input: './src/index.js',output:{file: 'dist/index.js'},plugins: [// 使用 terser 插件terser()] }
-
运行
npx rollup -c
命名进行打包,会发现,打包输出的文件中对 JavaScript 代码进行了压缩。