史上最清晰易懂的babel配置解析

准备工作

• 新建文件夹 webpack-babel
• 初始化 yarn init -y
• 安装 webpack

  yarn add webpack webpack-cli -D
  

• 安装 webpack 插件

  yarn add -D html-webpack-plugin clean-webpack-plugin
  

  html-webpack-plugin 用于自动生成 index.html
clean-webpack-plugin 用于每次打包时对上一次的 dist 文件进行清理，这两个插件跟 babel 没关系，只是这里用起来方便
• 安装 webpack-dev-server 用于启动一个 web 服务

  yarn add -D webpack-dev-server
  

• 新建 src 及入口文件 index.js，内容如下

  let ele = document.createElement("div")
  ele.innerHTML = "Hello world!"
  document.body.appendChild(ele)
  

• 新建 webpack 配置文件，内容如下

  const { CleanWebpackPlugin } = require('clean-webpack-plugin');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
  module.exports = {
    entry: {
      index: "./src/index.js"
    },
    devServer: {
      port: 9998
    },
    plugins: [
      new CleanWebpackPlugin(),
      new HtmlWebpackPlugin({
        title: '管理输出'
      })
    ],
  }
  

• 在 package.json 中添加脚本

  "scripts": {
    "serve": "webpack-dev-server --config webpack.config.js",
    "build": "webpack"
  }
  

• 跑一下试试

  yarn serve
  

成了！举国欢庆 ~

• 打个包试试

  yarn build
  

此时目录结构（打包后）

babel 部分

准备工作就绪之后，开始 babel 相关的部分

• 安装相关包

  yarn add -D babel-loader @babel/core @babel/preset-env
  

  babel-loader 允许你使用 Babel 和 webpack 转译 JavaScript 文件
  @babel/core 用于转换新的语法
  @babel/preset-env 用于配置哪些语法或 API 需要转换

• 首先修改 index.js 内容

  let a = 1;
  console.log(a);
  
  const fn = () => { };
  console.log(fn);
  

  这里使用了 ES6 的 let，和 箭头函数

• 使用 Can I use 查询语法支持情况，红色是不支持
  

  
  
  
  可以得知，在 IE11 上，这两种语法是都不支持的，实际运行的结果也是如此
  
  报语法错误

• 修改 webpack.config.js

  module: {
    rules: [
      {
        test: /\.m?js$/,
        exclude: /(node_modules|bower_components)/,
        use: {
          loader: 'babel-loader',
          options: {
            presets: [
              [
                '@babel/preset-env',
                {
                  debug: true,
                  targets: {
                    browsers: ["ie >= 11"]
                  }
                }
              ]
            ],
          }
        }
      }
    ]
  },
  

• 再跑一次

  yarn serve
  

没有再报错了

mode: "development",      //  强制声明为 development 模式
devtool: "none"        //  关闭 sourcemap

• 修改完后，打包

  yarn build
  

如果我们把条件换成支持这两种语法的浏览器呢？

• 修改 webpack.config.js，chrome 60 版本已经支持 let 和 箭头函数，打包后代码 不应该 再被转换。

  browsers: ["chrome >= 60"]
  

• 再次打包

  yarn build
  

此时并没有被转换

补充一下，如果开启了 debug，就可以在终端查看相关代码转换信息

开启 debug 后

• 换回之前的条件，继续调试

  browsers: ["ie >= 11"]
  

• 清空 index.js，将 index.js 的内容改为

  const fn = async () => {
    let r = await Promise.resolve(666)
    console.log(r)
  }
  fn()
  

• 运行 yarn serve 继续在 ie11 中查看
  

  报错了

• 从报错可以看到，需要引入 regenerator-runtime。可以通过以下三种方式解决：
  方法1：引入 @babel/polyfill，注意是生产依赖

  yarn add @babel/polyfill
  

  引入 @babel/polyfill 后，可以发现还引入了两个依赖， core-js 和 regenerator-runtime，而后者正是我们需要的
  

补充一下 @babel/core，core-js 和 regenerator-runtime 的作用

以上内容可在开启 debug 后，在终端查看日志

在 index.js 中引入 @babel/polyfill，注意，是在所有代码最上面引入

import "@babel/polyfill"

运行

yarn serve

成功运行

打包看一下

yarn build

一万多行。。

dist/index.js

includes，values 等方法都被引入

presets: [
  [
    '@babel/preset-env',
      {
        debug: true,
        targets: {
          browsers: ["ie >= 11"]
        },
        useBuiltIns: "usage"      //  看这里
      }
    ]
  ]

再次打包，剩下 2000 多行，只保留了处理 async 的部分

以上可以通过开启 debug 在控制台中查看

当配置为 entry 时

当配置为 usage 时

方法二：
首先移除 @babel/polyfill

yarn remove @babel/polyfill

安装@babel/plugin-transform-runtime，@babel/runtime

yarn add -D @babel/plugin-transform-runtime
yarn add @babel/runtime

安装 @babel/runtime 时可以发现只有 regenerator-runtime，没有 core-js，这就意味着 Promise，assign 不会被转译

plugins: [
  [
    "@babel/plugin-transform-runtime"
  ]
]

运行一下

方法三：
先移除 @babel/runtime 再安装 @babel/runtime-corejs2

yarn remove @babel/runtime
yarn add @babel/runtime-corejs2

module: {
  rules: [
    {
      test: /\.m?js$/,
      exclude: /(node_modules|bower_components)/,
      use: {
        loader: 'babel-loader',
        options: {
          presets: [
            [
              '@babel/preset-env',
              {
                debug: true,
                targets: {
                  browsers: ["ie >= 11"]
                  // browsers: ["chrome >= 60"]
                },
                useBuiltIns: "usage"
              }
            ]
          ],
          plugins: [
            [
              "@babel/plugin-transform-runtime",
              {
                "corejs": 2,
              }
            ]
          ]
        }
      }
    }
  ]
}

修改后，再次运行项目，又恢复了正常 Promise，async，Object.assign 均可以跑在 IE11 上了

• 直接引入 @babel/polyfill 的方式和引入 @babel/plugin-transform-runtime + @babel/runtime-corejs2 的方式区别在于，前者会污染全局变量。
  例如，如果使用@babel/polyfill 的方式，在 IE11 控制台输入 Promise 会正常打印，而使用后面的方式，在 IE11 控制台中输入 Promise 则会提示未定义

@babel/polyfill

@babel/plugin-transform-runtime + @babel/runtime-corejs2

• 补充一下，比如多个文件都使用了 class 语法，语法转换时，会出现多个转换的帮助函数，使用 @babel/plugin-transform-runtime 用于将多个帮助函数合并为一个，此外，生产环境需要 @babel/runtime 配合