Babel 中文文档
  • 印记中文
  • 文档
  • 配置
  • 试用
  • 视频
  • 博客
  • 赞助
  • 团队
  • GitHub

›配置参考

指南

  • 什么是 Babel?
  • 使用指南
  • 配置 Babel
  • 学习 ES2015
  • 升级至 Babel 7

配置参考

  • 配置文件
  • Config Options
  • 预设
  • 插件
  • 插件列表
  • Compiler assumptions

预设

  • @babel/preset-env
  • @babel/preset-react
  • @babel/preset-typescript
  • @babel/preset-flow

杂项

  • 路线图
  • 注意事项
  • 新增特性时间轴
  • FAQ
  • 编辑器

集成包

  • @babel/cli
  • @babel/polyfill
  • @babel/plugin-transform-runtime
  • @babel/register
  • @babel/standalone

工具包

  • @babel/parser
  • @babel/core
  • @babel/generator
  • @babel/code-frame
  • @babel/runtime
  • @babel/template
  • @babel/traverse
  • @babel/types

帮助工具包

  • helper-compilation-targets
  • helper-module-imports
Edit

插件

通过在 配置文件 中应用插件(或 预设),可以启用 Babel 的代码转换。

使用一个插件

如果插件在 npm 中,你可以传入插件的名字,Babel 会检查它是否安装在 node_modules 中。这将被添加到 plugins 配置项,该选项接受一个数组。

{
  "plugins": ["babel-plugin-myPlugin", "@babel/plugin-transform-runtime"]
}

你还可以指定插件的 相对/绝对 路径。

{
  "plugins": ["./node_modules/asdf/plugin"]
}

更多有关配置插件或预设的详细信息,请查阅 命名规范化。

转换类插件

这些插件可以转译你的代码。

转换类插件将启用相应的语法类插件,所以你不必两者都指定。

语法类插件

大多数语法可以通过 Babel 进行转译。在比较罕见的情况下(如果转译还没有实现,或者没有默认的实现方式),你可以使用 @babel/plugin-syntax-bigint 之类的插件来只允许 Babel 解析 特定类型的语法。例如你希望 Babel 只执行代码分析或代码重构,以此来保留源代码。

注意:如果你已经使用了相应的转换插件,则不需要指定语法插件,因为它会自动启用。

或者,你也可以在 Babel 解析器中设定相应 plugins 选项:

你的 .babelrc:

{
  "parserOpts": {
    "plugins": ["jsx", "flow"]
  }
}

插件排序

排序对于插件中的每个访问者来说都很重要。

这意味着如果两次转译都访问了 "Program" 节点,则转译将按插件或预设的顺序执行。

  • 插件在预设之前运行。
  • 插件排序是从第一个到最后一个。
  • 预设顺序是颠倒的(最后一个到第一个)。

示例:

{
  "plugins": ["transform-decorators-legacy", "transform-class-properties"]
}

将先运行 transform-decorators-legacy 再运行 transform-class-properties。

重要的是要记住,使用预设时,顺序是 颠倒的。例如下面:

{
  "presets": ["@babel/preset-env", "@babel/preset-react"]
}

将按以下顺序运行:先 @babel/preset-react 再 @babel/preset-env。

插件选项

插件和预设都可以通过将名称和选项对象包装在数组中来指定配置内的选项。

如果不指定选项,则这些写法都是等效的:

{
  "plugins": ["pluginA", ["pluginA"], ["pluginA", {}]]
}

若要指定选项,请传递一个以对象,其中键作为选项名称。

{
  "plugins": [
    [
      "transform-async-to-module-method",
      {
        "module": "bluebird",
        "method": "coroutine"
      }
    ]
  ]
}

预设设置选项的工作原理与插件完全相同:

{
  "presets": [
    [
      "env",
      {
        "loose": true,
        "modules": false
      }
    ]
  ]
}

插件开发

请参考优秀的 babel 手册 学习如何创建自己的插件。

一个逆转名称的简单插件示例(来自首页):

export default function() {
  return {
    visitor: {
      Identifier(path) {
        const name = path.node.name;
        // 逆转名称:JavaScript -> tpircSavaJ
        path.node.name = name
          .split("")
          .reverse()
          .join("");
      },
    },
  };
}
← 预设插件列表 →
  • 使用一个插件
  • 转换类插件
  • 语法类插件
  • 插件排序
  • 插件选项
  • 插件开发
Babel 中文文档
文档
学习 ES2015
社区
视频用户Stack OverflowSlack 频道Twitter
更多
博客GitHub 组织GitHub 仓库Website 仓库旧版网址 6.x旧版网址 5.x