# @atom/babel7-transpiler 中文文档

规范地址：https://npmcn.com/package/%40atom/babel7-transpiler/

版本：1\.0\.0-1
npm 元数据更新时间：2022-04-04T16:14:25.640Z
中文译文更新时间：2026-11-07T03:30:29.540Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5.7 kB，3 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2019-02-25T17:22:37.211Z
- 最新版本发布：2019-02-25T19:57:25.694Z
- 近 30 天下载量：2101（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

用 Babel 7 处理代码的原子包的转接器

## 安装

```sh
npm install @atom/babel7-transpiler
```

也可以使用：`pnpm add @atom/babel7-transpiler`、`yarn add @atom/babel7-transpiler`、`bun add @atom/babel7-transpiler`

## README

# 原子- babel7- 递译器

这个工程执行一个 Atom 软件包转接器,将您的软件包文件与 Babel 7 转接.

## 使用量

1.  安装软件包
2.  添加一个 `atomTranspilers` 条目 `package.json`
3.  安装 Babel 预设和插件,并按您的意愿配置 Babel

详细情况:

**1\. 联合国.** 首先从 npm 注册处安装软件包 :

```
npm install --save @atom/babel7-transpiler
```

**2\. 联合国.** 下一个,修改您的 `package.json` 用于您想要 Babel 处理的 Atom Flight 手册中描述的任何文件。 例如,处理结束于 `.js` 在你的包裹,你可以使用:

```javascript
{
  ...
  "atomTranspilers": [
    {
      "glob": "**/*.js",
      "transpiler": "@atom/babel7-transpiler"
    }
  ]
}
```

**3个.** 最后,安装 Babel 和所有您想要作为正常使用的预设和插件. 简单来说,如果想要使用ES2015和React预设,你可能会运行:

```
npm install --save babel-preset-env babel-preset-react
```

然后创建一个 [`.babelrc` 文件](http://babeljs.io/docs/usage/babelrc/) 配置 Babel 以使用它们 :

```json
{
  "presets": ["env", "react"]
}
```

您也可以在您的 `package.json` 在可选内容中 `options` 对象; 子密钥 `babel`如果它存在,将会通过 [作为选项 `babel.transformSync`](https://babeljs.io/docs/en/babel-core#transformsync)。请注意,如果您不想让 Babel 搜索目录的层次 `.babelrc` 文件,需要添加 `"babelrc": false` 选项。 否则Babel可能会误用用户的 `.babelrc` 在试图构建您的软件包时, 从文件系统的其他部分 .

```javascript
{
  // ...
  "atomTranspilers": [
    {
      "glob": "**/*.js",
      "transpiler": "@atom/babel7-transpiler",
      "options": {
        "babel": {
          "presets": ["es2015", "react"],
          "babelrc": false
        }
      }
    }
  ]
}
```

### 选项

您可指定下列选项为 `options` 对象 `package.json`数字 :

| 选项 | 默认 | 说明 |
| --: | --- | --- |
| `setBabelEnv` | `false`, (中文(简体) ), `true` 或字符串 | 设置 `BABEL_ENV` 环境变量。 何时 `true`,设置为 `"development"` 何时 `atom.inDevMode()` 或者说 `atom.inSpecMode()` 是真的,还有 `"production"` 否则。 当给定为字符串时,使用该名称的环境变量的值取而代之. 特性返回 `BABEL_ENV` 改为转接完成后的上个值. |
| `babel` | `{}` | 作为第二个参数的选项 `babel.transform` (同样的选项,你可以在 `.babelrc`) (中文(简体) ). |
| `cacheKeyFiles` | `[]` | 在决定是否使用缓存时要包含的一系列文件 。 举例来说,强迫重新编译,随时 `.babelrc` 变化,添加 `.babelrc` 到此数组. |

## 其他细节

### 来源地图

为了启用 Atom 内部的源地图, 设置 Babel `sourceMaps` 选项到 `"inline"` 在你的 Babel 配置.

### Babel环境

贝贝支持 [一个名为 `env`](https://babeljs.io/docs/usage/babelrc/#env-option) 这使得您可以在每个环境的基础上配置 Babel 。 Babel环境通过一个叫做 `BABEL_ENV`; 本模块将环境变量自动设置为 `"development"` 如果 Atom 处于 dev 模式(`atom.inDevMode()` 返回时 `true`和 `"production"` 否则.

## 常见问题

### @atom/babel7-transpiler 是什么？

用 Babel 7 处理代码的原子包的转接器

### 如何安装 @atom/babel7-transpiler？

在项目目录运行 npm install @atom/babel7-transpiler，或使用 pnpm add / yarn add / bun add。

### @atom/babel7-transpiler 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/atom\_\_babel7-transpiler 是否存在。

### @atom/babel7-transpiler 支持 ESM 还是 CommonJS？

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

### @atom/babel7-transpiler 可以商用吗？

@atom/babel7-transpiler 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @atom/babel7-transpiler 的下载量有多少？

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

### @atom/babel7-transpiler 还在维护吗？

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