如何用Rollup打包一个库类型的JavaScript项目？

使用 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：

根据你的项目需求，安装常用插件：

• @rollup/plugin-node-resolve：让 Rollup 能加载 node_modules 中的第三方模块。
• @rollup/plugin-commonjs：将 CommonJS 模块转换为 ES6 模块。
• @rollup/plugin-typescript（可选）：如果你使用 TypeScript。
• tslib（可选）：TypeScript 辅助函数库。

编写 rollup.config.js 配置文件

在项目根目录创建 rollup.config.js，以下是一个典型的库项目配置示例：

立即学习“Java免费学习笔记（深入）”；

说明：

• input 指定库的入口文件，通常是 src/index.ts 或 index.js。
• output 数组支持多格式输出，推荐同时提供 ESM 和 CJS，以兼容不同环境。
• external 列出你不想被打包的依赖，比如 React、Lodash 等，它们应由使用者提供。

配置 package.json 构建脚本与模块字段

在 package.json 中设置正确的字段，帮助工具识别你的库：

豆包大模型

字节跳动自主研发的一系列大型语言模型

834

查看详情

关键字段解释：

• main：Node.js 使用的 CommonJS 入口。
• module：支持 Tree-shaking 的 ES Module 入口。
• types：TypeScript 类型定义文件路径（需配合 tsc 生成）。
• files：指定发布到 npm 的文件夹，避免上传无关内容。

如果你使用 TypeScript，确保 tsconfig.json 启用了类型生成：

执行构建并发布

运行构建命令：

构建成功后，会在 dist 目录生成对应文件。你可以本地测试：

最后发布到 npm：

以上就是如何用Rollup打包一个库类型的JavaScript项目？的详细内容，更多请关注php中文网其它相关文章！