Babel Docs：JavaScript 编译器 Babel 的官方指南、配置参考与 8.0 升级说明

首页的定位与三类用途

Docs 首页的 What is Babel? 页面写明，Babel 主要用于三件事：转换语法、为目标环境补充缺失的功能（页面举例为借助 core-js 等第三方 polyfill），以及做源代码变换（codemods）。页面中的示例是把箭头函数 n => n + 1 转换成普通的 function 写法。

Babel 文档 What is Babel? 页面截图，左侧为 Guides 目录，正文展示一段把箭头函数改写为普通 function 的 JavaScript 示例，下方有 TIP 提示框

截图与截至 2026 年 10 月的 What is Babel? 页面一致。

指南：安装与配置

Usage Guide 先说明 Babel 工具链中有哪些工具，并区分“终端用户”与“集成 Babel 的开发者”两类读者。页面还提示，如果使用某个框架，Babel 的配置可能已由框架处理，此时应改用页面给出的交互式设置指南。

页面概述部分给出基本步骤：用 npm install --save-dev @babel/core @babel/cli @babel/preset-env 安装三个包，再在项目根目录新建 babel.config.json，写入 @babel/preset-env 的配置。示例中的 targets 与 useBuiltIns 等选项需要按自己要支持的浏览器调整，页面注明示例中的浏览器版本只是随意选取的数值。侧边栏中的 Configure Babel 页面专门讲配置方式。

升级 Babel 8：用户说明与 API 说明分开看

Babel 8 的升级说明分为两份。Upgrade to Babel 8 面向用户侧的破坏性变更；Upgrade to Babel 8 (API) 则面向直接使用 Babel API 的读者，例如插件作者，或把 Babel 当作库使用的项目。页面开头写明，它列出了 Babel 8.0.0 的破坏性变更，以及从 7.0.0 升级时如何调整用法。页面中的 INFO 提示框建议先读用户侧的迁移指南。

Babel 文档 Upgrade to Babel 8 (API) 页面截图，显示面向 API 使用者的开头说明与 INFO 提示框，下方 AST Changes 小节给出动态 import() 在 Babel 7 与 8 中的节点对比示例

截图与截至 2026 年 10 月的页面一致。

API 页的第一项是语法树（AST）的变化。动态 import() 在 Babel 7 中以 CallExpression 表示，在 Babel 8 中改用 ImportExpression 节点。页面建议插件作者从 7.23.0 起通过解析选项 createImportExpressions 提前测试新结构，并说明 Babel 7 的 import() 结构已视为弃用，解析选项计划在 Babel 9 中移除。另一项变化是 BigIntLiteral 的 value 改为 bigint 类型，不再是字符串。

配置参考、预设与集成包

左侧目录除指南外，还有 Config Reference、Presets、Misc、Integration Packages、Tooling Packages 和 Helper Packages。What is Babel? 页面在介绍各项能力时，分别列出了三个预设的安装命令：React 预设 @babel/preset-react、Flow 预设 @babel/preset-flow，以及 TypeScript 预设 @babel/preset-typescript，并提醒 Babel 只负责去除类型注解，不做类型检查。

适合谁阅读

这份文档适合需要让新语法在旧环境中可用的 JavaScript 开发者，适合正在把项目迁移到 Babel 8 的维护者，也适合编写 Babel 插件或把 Babel 作为库调用的开发者。后者应优先阅读 API 升级说明。