使用 Rollup 打包 JavaScript 库，需安装 rollup 及插件如 @rollup/plugin-node-resolve、commonjs、typescript，配置 rollup.config.js 指定 input、output 多格式（esm/cjs）、external 依赖，结合 package.json 的 main/module/types/files 字段与 tsconfig.json 类型生成，执行 npm run build 构建并 npm publish 发布。
打包一个库类型的 JavaScript 项目，使用 Rollup 是一个非常高效且流行的选择，尤其适合构建用于发布到 npm 的库。Rollup 支持 Tree-shaking、模块化输出，并能生成多种格式的产物（如 ES Module、CommonJS、UMD 等）。以下是具体步骤和配置建议。
安装 Rollup 及必要插件
在项目根目录初始化 npm 并安装 Rollup：
npm init -y
npm install –save-dev rollup
根据你的项目需求，安装常用插件：
@rollup/plugin-node-resolve：让 Rollup 能加载 node_modules 中的第三方模块。 @rollup/plugin-commonjs：将 CommonJS 模块转换为 ES6 模块。 @rollup/plugin-typescript（可选）：如果你使用 TypeScript。 tslib（可选）：TypeScript 辅助函数库。npm install –save-dev @rollup/plugin-node-resolve @rollup/plugin-commonjs
npm install –save-dev @rollup/plugin-typescript tslib
编写 rollup.config.js 配置文件
在项目根目录创建 rollup.config.js，以下是一个典型的库项目配置示例：
立即学习“Java免费学习笔记（深入）”；
import resolve from ‘@rollup/plugin-node-resolve’;
import commonjs from ‘@rollup/plugin-commonjs’;
import typescript from ‘@rollup/plugin-typescript’;
export default {
input: ‘src/index.ts’, // 入口文件
output: [
{
file: ‘dist/bundle.esm.js’,
format: ‘esm’ // ES Module 格式
},
{
file: ‘dist/bundle.cjs.js’,
format: ‘cjs’ // CommonJS 格式
}
],
plugins: [
resolve(),
commonjs(),
typescript({ tsconfig: ‘./tsconfig.json’ })
],
external: [‘lodash’] // 外部依赖，不打包进最终文件
};
说明：
input 指定库的入口文件，通常是 src/index.ts 或 index.js。 output 数组支持多格式输出，推荐同时提供 ESM 和 CJS，以兼容不同环境。 external 列出你不想被打包的依赖，比如 React、Lodash 等，它们应由使用者提供。
配置 package.json 构建脚本与模块字段
在 package.json 中设置正确的字段，帮助工具识别你的库：
{
“name”: “your-awesome-lib”,
“version”: “1.0.0”,
“main”: “dist/bundle.cjs.js”,
“module”: “dist/bundle.esm.js”,
“types”: “dist/types/index.d.ts”,
“files”: [
“dist”
],
“scripts”: {
“build”: “rollup -c”
}
}
关键字段解释：
main：Node.js 使用的 CommonJS 入口。 module：支持 Tree-shaking 的 ES Module 入口。 types：TypeScript 类型定义文件路径（需配合 tsc 生成）。 files：指定发布到 npm 的文件夹，避免上传无关内容。
如果你使用 TypeScript，确保 tsconfig.json 启用了类型生成：
{
“compilerOptions”: {
“outDir”: “dist”,
“declaration”: true,
“declarationDir”: “dist/types”
}
}
执行构建并发布
运行构建命令：
npm run build
构建成功后，会在 dist 目录生成对应文件。你可以本地测试：
npm pack
最后发布到 npm：
npm publish基本上就这些。Rollup 能帮你产出干净、高效、兼容性好的库文件，特别适合组件库、工具函数库等场景。关键是配置好输入输出、外部依赖和模块规范。
以上就是如何用Rollup打包一个库类型的JavaScript项目？的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1526416.html
微信扫一扫 
支付宝扫一扫 
