Babel 入门指南

Babel 入门指南

​⚠️ 注意: Babel 可以与很多构建工具(如 BrowserifyGruntGulp 等)进行集成。由于本教程选择 Webpack ,所以只讲解与 Webpack 的集成。想了解如何与其它工具集成,请参考:官方文档 - installation

简介

Babel 是一个通用的多用途 JavaScript 编译器。

Babel 能做什么?

  • Babel 通过语法转换来支持最新版本的 JavaScript (ES6),而不用等待浏览器的支持。
  • Babel 可以转换 React 的 JSX 语法和删除类型注释。
  • Babel 是由插件构建的。因此,你可以根据自己的需要订制。
  • 支持 source map ,所以您可以轻松调试您编译的代码。

Babel 不能做什么?

  • Babel 只转换语法(如箭头函数),不支持新的全局变量。但是,您可以使用 babel-polyfill 来辅助支持。

安装 Babel

babel-cli

babel-cli 是 Babel 的命令行工具。

安装

# 本地安装
$ npm install --save-dev babel-cli
# 全局安装
$ npm install --global babel-cli

用法

# 将编译后的结果直接输出至终端
$ babel example.js

# 将结果写入到指定的文件
$ babel example.js --out-file compiled.js
$ babel example.js -o compiled.js

# 将一个目录整个编译成一个新的目录
$ babel src --out-dir lib
$ babel src -d lib

package.json 集成

​? 提示: 建议使用本地安装方式安装 babel-cli 。 原因在与:

  1. 在同一台机器上的不同项目或许会依赖不同版本的 Babel 并允许你有选择的更新。
  2. 这意味着你对工作环境没有隐式依赖,这让你的项目有很好的可移植性并且易于安装。

本地安装 babel-cli ,直接使用 babel 命令将无法识别。你可以选在在 package.json 文件的  scripts 属性中定义命令。npm 会自动找到本地安装的库。

{
  "scripts": {
    "build": "babel src -d lib"
  },
  "devDependencies": {
    "babel-cli": "^6.0.0"
  },
}

现在可以在终端里执行命令:

$ npm run build

​? 示例DEMO01: (SOURCE) 说明: 示例的上一级目录 codes/chapter04/babel 已经配好了配置文件。 在 codes/chapter04/babel 路径下执行命令: $ npm install $ npm run demo01 会生成一个 dist/demo01 目录,其中就是被转码后的文件。

babel-node

babel-cli 工具自带一个 babel-node 命令,提供一个支持 ES6 的 REPL 环境。它支持 Node 的 REPL 环境的所有功能,而且可以直接运行 ES6 代码。

它不用单独安装,而是随 babel-cli 一起安装。然后,执行 babel-node 就进入 PEPL 环境。

然后用 babel-node 来替代 node 运行所有的代码:

$ babel-node
> (x => x * 2)(1)
2

babel-node 命令可以直接运行ES6脚本:

$ babel-node example.js

如果用 npm 的话只需要这样做:

{
  "scripts": {
    "script-name": "babel-node script.js"
  },
  "devDependencies": {
    "babel-cli": "^6.0.0"
  },
}

然后,执行命令:

$ npm run babel-node

babel-register

下一个常用的运行 Babel 的方法是通过 babel-register。这种方法只需要引入文件就可以运行 Babel,或许能更好地融入你的项目设置。

​⚠️ 注意: 这种方法并不适合正式产品环境使用。 直接部署用此方式编译的代码不是好的做法。 在部署之前预先编译会更好。 不过用在构建脚本或是其他本地运行的脚本中是非常合适的。

安装

$ npm install --save-dev babel-register

使用

  1. 创建 index.js 文件:
console.log("Hello world!");

这是,使用 node index.js 来运行它是不会使用 Babel 来编译的。所以我们需要设置 babel-register。.

  1. 创建 register.js 文件:
require("babel-register");
require("./index.js");

这样做可以把 Babel 注册到 Node 的模块系统中并开始编译其中 require 的所有文件。

  1. 执行命令

现在我们可以使用 register.js 来代替 node index.js 来运行了。

$ node register.js

需要注意的是:你不能在你要编译的文件内同时注册 Babel,因为 node 会在 Babel 编译它之前就将它执行了。

​? 示例DEMO02: (SOURCE) 说明: 示例的上一级目录 codes/chapter04/babel 已经配好了配置文件。 在 codes/chapter04/babel 路径下执行命令: $ npm install $ npm run demo02 控制台会打印如下内容: > node demo02/register.js Hello world!

babel-core

如果你需要以编程的方式来使用 Babel,可以使用 babel-core 这个包。

安装

$ npm install babel-core

使用

在代码中引入 babel-core

var babel = require("babel-core");

编译 API

# 如果是字符串形式的 JavaScript 代码,可以使用 transform 编译
babel.transform("code();", options);
// => { code, map, ast }

# 如果是文件的话,异步编译使用 transformFile
babel.transformFile("filename.js", options, function(err, result) {
  result; // => { code, map, ast }
});
# 如果是文件的话,同步编译使用 transformFileSync
babel.transformFileSync("filename.js", options);
// => { code, map, ast }

# 要是已经有一个 Babel AST(抽象语法树)了就可以直接从 AST 进行转换
babel.transformFromAst(ast, code, options);
// => { code, map, ast }

与 webpack 集成

​? 提示: 本教程由于选择的编译工具为 webpack ,所以这里只介绍与 webpack 的集成。 实际上,Babel 还可以与其它许多工具集成,更多内容参考:官方文档 - setup

安装

$ npm install --save-dev babel-loader babel-core

配置

在 Chapter03 的 Webpack 资源管理 一文中,介绍过使用 babel-loader 来处理 React 语法。

webpack.config.js 配置如下:

// 关于模块配置
module: {

  // 模块规则(配置 loader、解析器等选项)
  rules: [
    {
      // 语义解释器,将 js/jsx 文件中的 es2015/react 语法自动转为浏览器可识别的 Javascript 语法
      test: /\.jsx?$/,
      include: path.resolve(__dirname, "app"),
      loader: "babel-loader",
    },
  ]
},

​? 示例 chapter03-jigsaw: (SOURCE) chapter04-jigsaw: (SOURCE) 说明: chapter04-jigsawchapter03-jigsaw 相比,多了一个 .babelrc 文件。它其实是将 chapter03-jigsaw 中的 webpack.common.js 文件里的 babel-loader 的配置移入了 .babelrc 文件。 这两个代码目录的执行结果完全相同。 执行方法: $ npm install # 开发环境 - 本地启动一个访问地址为 localhost:9000 的 web app $ npm run dev # 开发环境 - 生成一个 dist 目录,其中打包了所有资源文件,在浏览器打开 index.html,可以看到和开发环境差不多的展示。 $ npm run prod # 清除输出目录 dist $ npm run clean

配置 Babel

​? 提示: 由于 Babel 是一个非常灵活的通用编译器,因此默认情况下它反而什么都不做。 你需要通过配置文件,明确地告诉 Babel 应该要做什么。

.babelrc

.babelrc 文件是 Babel 的默认配置文件。

.babelrc 文件的内容形式就是序列化的 JSON。

该文件用来设置转码规则(presets)和插件(plugins),基本格式如下:

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

转码规则(preset)

转码规则可以告诉 Babel 去处理什么语法。

常见的转码规则有:

  • babel-preset-es2015

这是 ES2015(最新版本的 JavaScript 标准,也叫做 ES6)的转码规则。使用它后,Babel 可以将 ES6 语法转码为普通 JavaScript(即 ES5) 语法。

  • babel-preset-react

这是 React 的转码规则。使用它后,Babel 可以将 React 语法转码为普通 JavaScript 语法。

  • babel-preset-stage-x

这是 ES7 不同阶段语法提案的转码规则。使用它后,Babel 可以将 ES7 不同阶段语法转码为普通 JavaScript 语法。

​? 提示: JavaScript 还有一些提案,正在积极通过 TC39(ECMAScript 标准背后的技术委员会)的流程成为标准的一部分。 这个流程分为 5(0-4)个阶段。 随着提案得到越多的关注就越有可能被标准采纳,于是他们就继续通过各个阶段,最终在阶段 4 被标准正式采纳。以下是4 个不同阶段的(打包的)预设:

  • babel-preset-stage-0
  • babel-preset-stage-1
  • babel-preset-stage-2
  • babel-preset-stage-3

stage-4 预设是不存在的因为它就是上面的 es2015 预设。 以上每种预设都依赖于紧随的后期阶段预设。例如,babel-preset-stage-1 依赖 babel-preset-stage-2,后者又依赖babel-preset-stage-3

安装

# es2015(即ES6)语法转码规则
$ npm install --save-dev babel-preset-es2015

# react 语法转码规则
$ npm install --save-dev babel-preset-react

# stage 是指 ES7 不同阶段的语法转码规则,选装一个即可
$ npm install --save-dev babel-preset-stage-0
$ npm install --save-dev babel-preset-stage-1
$ npm install --save-dev babel-preset-stage-2
$ npm install --save-dev babel-preset-stage-3

使用

安装完后,需要在配置文件 .babelrc 中引入项目中实际需要的预设转码规则,让 Babel 得以知道规则。

形式如下:

{
  "presets": [
    "es2015",
    "react",
    "stage-0"
  ],
  "plugins": []
}

插件(plugins)

插件是 Babel 的核心。

Babel 插件大致分为三类:

  • 转码插件

有很多种插件:将ES6 / ES2015转换为ES5,转换为ES3,minification,JSX,flow,实验功能等等。

  • 语法插件

这些只是使转码插件能够解析某些功能(转码插件已经包含语法插件,因此这两个功能你都不需要):babel-plugin-syntax-x

  • 助手

这些主要用于各种插件内部使用:babel-helper-x

更多插件请在 npm 搜索(真的好多!)

更详细介绍请参考:官方文档 - 插件

在其它工具中配置

​?​ 提示: 除了在 .babelrc 文件中定义 Babel 配置。实际上,还可以在其他工具中对其进行配置。

package.json 中配置

可以在 package.json 文件的 babel 属性中配置 Babel 规则。

配置方法与 .babelrc 文件完全相同。

形式如下:

"babel": {  
  "presets": [  
    "es2015"  
  ]
  "plugins": []
},  

webpack.config.js 中配置

可以在 webpack.config.js 文件配置 babel-loader 时,直接在 options 属性中配置 Babel 规则。

形式如下:

{
  test: /\.jsx?$/,
  include: path.resolve(__dirname, "app"),
  exclude: /node_modules/,
  loader: "babel-loader",
  options: {
    presets: [
      [
        "es2015",
        {
          "modules": false
        }
      ],
      "react"
    ],
    plugins: [
      "syntax-dynamic-import",  // 动态导入插件
      "react-hot-loader/babel" // 开启 React 代码的模块热替换(HMR)
    ]
  },
}

执行 Babel 生成的代码

即便你已经用 Babel 编译了你的代码,但这还不算完。

babel-polyfill

Babel 几乎可以编译所有新潮的 JavaScript 语法,但对于 APIs 来说却并非如此。

比方说,下列含有箭头函数的需要编译的代码:

function addAll() {
  return Array.from(arguments).reduce((a, b) => a + b);
}

最终会变成这样:

function addAll() {
  return Array.from(arguments).reduce(function(a, b) {
    return a + b;
  });
}

然而,它依然无法随处可用。因为并非所有的 JavaScript 环境都支持 Array.from

为了解决这个问题,我们使用一种叫做 Polyfill(代码填充,也可译作兼容性补丁) 的技术。 简单地说,polyfill 即是在当前运行环境中用来复制(意指模拟性的复制,而不是拷贝)尚不存在的原生 api 的代码。 能让你提前使用还不可用的 APIs,Array.from 就是一个例子。

Babel 提供了 babel-polyfill 来支持 polyfill 。

安装

$ npm install --save babel-polyfill

使用

然后,只需要在文件顶部导入 babel-polyfill 就可以了:

import "babel-polyfill";

babel-runtime

babel-runtime 与 polyfill 类似,不同之处在于它不修改全局范围,并且与 babel-plugin-transform-runtime(通常在库/插件代码中)一起使用。

为了实现 ECMAScript 规范的细节,Babel 会使用“助手”方法来保持生成代码的整洁。

由于这些助手方法可能会特别长并且会被添加到每一个文件的顶部,因此你可以把它们统一移动到一个单一的“运行时(runtime)”中去。

通过安装 babel-plugin-transform-runtime 和 babel-runtime 来开始。

$ npm install --save-dev babel-plugin-transform-runtime
$ npm install --save babel-runtime

然后更新 .babelrc

{
  "presets": [
    "es2015",
    "react",
    "stage-0"
  ],
  "plugins": [
    "transform-runtime",
    "transform-es2015-classes"
  ]
}

现在,Babel 会把这样的代码:

class Foo {
  method() {}
}

编译成:

import _classCallCheck from "babel-runtime/helpers/classCallCheck";
import _createClass from "babel-runtime/helpers/createClass";

let Foo = function () {
  function Foo() {
    _classCallCheck(this, Foo);
  }

  _createClass(Foo, [{
    key: "method",
    value: function method() {}
  }]);

  return Foo;
}();

这样就不需要把 _classCallCheck 和 _createClass 这两个助手方法放进每一个需要的文件里去了。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏程序员的SOD蜜

Vue.js 入门指南之“前传”(含sublime text 3 配置) 1,下载安装Node.js2,配置Vue环境3,Vue初探4,配置sublime Text

题记:关注Vue.js 很久了,但就是没有动手写过一行代码,今天准备入手,却发现自己比菜鸟还菜,于是四方寻找大牛指点,才终于找到了入门的“入门”,就算是“入门指...

3409
来自专栏地方网络工作室的专栏

Vue2+VueRouter2+Webpack+Axios 构建项目实战2017重制版(十四)在项目中使用 jQuery

Vue2+VueRouter2+Webpack+Axios 构建项目实战2017重制版(十四)在项目中使用 jQuery 前情回顾 在上一篇博文中,我们讲到了,...

1967
来自专栏阮一峰的网络日志

Vim 配置入门

Vim 的配置不太容易,它有自己的语法,许许多多的命令。我总是记不清楚,所以就整理了下面这篇文章,列出主要配置项的含义。

1241
来自专栏闪电gogogo的专栏

sublime学习笔记

1 sublime的几个优点 1.操作简单上手快 2.支持多点编辑:ctrl + 光标 3.基于Package Control强大的包管理功能 4.闪电一样的查...

3026
来自专栏IMWeb前端团队

PhantomJS基础及示例

概述 PhantomJS is a headless WebKit scriptable with a JavaScript API. It has fast...

2318
来自专栏JadePeng的技术博客

weex官方demo weex-hackernews代码解读(上)

一、介绍 weex 是阿里出品的一个类似RN的框架,可以使用前端技术来开发移动应用,实现一份代码支持H5,IOS和Android。最新版本的weex已默认将v...

3255
来自专栏前端说吧

【本周主题】JavaScript单线程与异步

651
来自专栏魏琼东

一步一步教你使用AgileEAS.NET基础类库进行应用开发-WinForm应用篇-在UI中应用DataUIMapper组件

系列回顾       WinForm篇我用了一步一步教你使用AgileEAS.NET基础类库进行应用开发-WinForm应用篇-实例一个模块(商品字典)和一步一...

1979
来自专栏全沾开发(huā)

如何从0开发一个Atom组件

如何从0开发一个Atom组件 最近用Atom写博客比较多,然后发现一个很严重的问题。。 没有一个我想要的上传图片的方式,比如某乎上边...

3505
来自专栏Albert陈凯

2018-11-28 最常用的Intellij IDEA快捷键

除了上面的快捷键之外,还有非常多有用的快捷键,几乎每一个在Intellij中的操作都有一个等同的快捷键。 我们很难一下全部学习到位,需要一定的时间和练习。 我每...

992

扫码关注云+社区