rollup-plugin-babel 技术文档

rollup-plugin-babel 技术文档

rollup-plugin-babel This package has moved and is now available at @rollup/plugin-babel / https://github.com/rollup/plugins/tree/master/packages/babel 项目地址: https://gitcode.com/gh_mirrors/ro/rollup-plugin-babel

rollup-plugin-babel 是一个无缝集成 Rollup 和 Babel 的插件，它简化了在 Rollup 构建流程中使用 Babel 进行代码转译的过程，避免了重复配置和潜在的性能问题。

安装指南

根据您使用的 Babel 版本，执行相应的命令：

对于 Babel 7.x 用户：

npm install --save-dev rollup-plugin-babel@latest

而对于 Babel 6.x，则需要：

npm install --save-dev rollup-plugin-babel@3

请注意，此项目已迁移至 [@rollup/plugin-babel](https://github.com/rollup/plugins)，确保您的依赖是最新的。

项目的使用说明

命令行使用（Rollup）

首先，在您的 rollup.config.js 配置文件中引入并配置 rollup-plugin-babel：

import babel from 'rollup-plugin-babel';
import pkg from './package.json';

export default {
  input: 'src/index.js',
  output: [{ file: pkg.module, format: 'esm' }],
  plugins: [babel()],
};

如果您希望排除 node_modules 中的文件不进行 Babel 转换，可以这样做：

plugins: [
  babel({
    exclude: 'node_modules/**'
  }),
],

程序化使用

如果您偏好在脚本中直接控制 Rollup 的构建过程，可以如下操作：

import { rollup } from 'rollup';
import babel from 'rollup-plugin-babel';

rollup({
  input: 'main.js',
  plugins: [
    babel({
      exclude: 'node_modules/**'
    })
  ]
}).then(...)

项目API使用文档

rollup-plugin-babel 支持多种自定义配置选项，除了遵循 Babel 的标准配置外，还提供以下特有选项：

• externalHelpers: 控制是否将 Babel 辅助函数打包到最终产物。
• include 和 exclude: 使用 minimatch 模式来指定哪些文件应被 Babel 转码。
• externalHelpersWhitelist: 显式指定允许的辅助函数列表。
• extensions: 可以配置 Babel 处理的文件扩展名，默认为 .js, .jsx, .es6, .es, .mjs.

项目安装方式

在项目根目录下通过 npm 或者 yarn 添加依赖，按照上述安装指南中的对应版本指令执行即可完成安装。

总结

rollup-plugin-babel 通过其灵活的配置和自动化处理 Babel 辅助函数的能力，大大简化了在 Rollup 工作流中进行 ES6+ 代码向后兼容的转换。理解如何配置该插件，以及如何利用它的高级功能，是优化前端构建流程的关键。请根据您的具体需求调整配置，并留意 Babel 版本差异带来的变化，确保项目顺利运行。

rollup-plugin-babel This package has moved and is now available at @rollup/plugin-babel / https://github.com/rollup/plugins/tree/master/packages/babel 项目地址: https://gitcode.com/gh_mirrors/ro/rollup-plugin-babel