# @atlaspack/transformer-babel 中文文档

规范地址：https://npmcn.com/package/%40atlaspack/transformer-babel/

版本：2\.15\.26
npm 元数据更新时间：2026-09-15T23:43:11.474Z
中文译文更新时间：2026-11-07T03:20:46.811Z
软件包许可：\(MIT OR Apache-2\.0\)

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40atlaspack/transformer-babel
原文对照：https://npmcn.com/package/%40atlaspack/transformer-babel/?lang=original
项目主页：https://github.com/atlassian-labs/atlaspack#readme
源码仓库：https://github.com/atlassian-labs/atlaspack

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：238 kB，45 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 16\.0\.0
- 运行依赖：8 个
- 首次发布：2024-08-20T02:16:17.590Z
- 最新版本发布：2026-09-15T23:43:11.230Z
- 近 30 天下载量：2794（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：1060（近 12 个月 252 个）

## 中文简介

这个Atlaspack变压器插件负责用 Babel 转换资产. 用这个 `@babel/core` 解决 Babel 的配置 和 Babel 一样,如果找到的话, 使用它。 如果找不到文件系统配置, 它使用一个默认配置来支持

## 安装

```sh
npm install @atlaspack/transformer-babel
```

也可以使用：`pnpm add @atlaspack/transformer-babel`、`yarn add @atlaspack/transformer-babel`、`bun add @atlaspack/transformer-babel`

## README

# @atlaspack/ transfer-babel (中文(简体) )

这个Atlaspack变压器插件负责用 Babel 转换资产. 用这个 `@babel/core` 解决 Babel 的配置 和 Babel 一样,如果找到的话, 使用它。 如果找不到文件系统配置, 它会使用默认配置来支持最常见的大小写 .

## 默认配置

-   `@babel/preset-env` - 使用以下定义的目标: `package.json` 或默认的一组目标,如果没有指定要传递给 `@babel/preset-env` 作为选项。 它贯穿所有源代码以及安装的软件包,其浏览器列表的目标高于Atlaspack正在构建的应用程序.
-   `@babel/plugin-flow-strip-types` - 现在它正在配置流线插件,该插件使用晶体来检查是否有流线指令,如果有,则会显示字条类型\[TODO: 它应该对代码进行廉价检查,并且只有在找到流量指令时才应用插件,因为它可能影响当它不应该解析时\]
-   `@babel/plugin-transform-typescript` - 配置为带有解脱功能的文件 `.ts` 财务报告和审定财务报表 `.tsx`
-   `@babel/plugin-transform-react-jsx` - 如果文件有扩展名则配置 `.jsx` 或者如果在包中发现类似依赖性的反应作为依赖性. json.

## 自定义配置 perf 警告

Atlaspack现在支持了Babel所支持的所有配置格式,但其中一些有负面的性能影响.

-   `babel.config.js`编号 :`.babelrc.js` - 自从Babel 7以来,JS的配置文件现在得到了支持。 虽然这提供了灵活性,但会损害缓存性。 Atlaspack不能使用这些文件的内容来缓存,因为它们返回的配置仅基于内容是非决定性的. 进口依赖可能发生变化,或者结果可能基于环境变量。 因此,Atlaspack必须解决在每个建筑上装载这些文件,并确保其输出保持不变. 使用JS配置文件的另一个缺点是,它们最终是: `require()`由 Babel 编辑,所以当文件在表模式中发生变化时, Atlaspack 无法重建 。 为了避免这些业绩处罚,建议您使用 `babel.config.json` 或者说 `.babelrc` 文档代替.
-   `require('@babel')` - 随着JS配置文件的出现,现在可以在配置中直接要求预设和插件,而不是使用由Babel解决的名称或路径. 不幸的是,这并没有让阿特拉斯包获得任何关于转换中使用了哪些插件/预设的信息,因此阿特拉斯包将被迫在每个建筑上运行 Babel 转换. 建议避免这种类型的配置.

## 常见问题

### @atlaspack/transformer-babel 是什么？

这个Atlaspack变压器插件负责用 Babel 转换资产\. 用这个 @babel/core 解决 Babel 的配置 和 Babel 一样,如果找到的话, 使用它。 如果找不到文件系统配置, 它使用一个默认配置来支持

### 如何安装 @atlaspack/transformer-babel？

在项目目录运行 npm install @atlaspack/transformer-babel，或使用 pnpm add / yarn add / bun add。

### @atlaspack/transformer-babel 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @atlaspack/transformer-babel 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @atlaspack/transformer-babel 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 16\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @atlaspack/transformer-babel 可以商用吗？

@atlaspack/transformer-babel 使用 \(MIT OR Apache-2\.0\) 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @atlaspack/transformer-babel 的下载量有多少？

根据 npm 官方下载统计，@atlaspack/transformer-babel 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,794 次，日均约 93 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @atlaspack/transformer-babel 还在维护吗？

最新版本 2\.15\.26 发布于 2026/09/16（1 个月前）；至今共发布 1060 个版本，其中过去 12 个月发布了 252 个；首次发布于 2024/08/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。