# @beemo/dev 中文文档

规范地址：https://npmcn.com/package/%40beemo/dev/

版本：2\.1\.2
npm 元数据更新时间：2022-07-24T05:57:40.099Z
中文译文更新时间：2026-11-07T20:40:37.913Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：43 kB，58 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=14\.15\.0
- 运行依赖：20 个
- 首次发布：2021-04-20T04:39:40.597Z
- 最新版本发布：2022-07-24T05:57:40.002Z
- 近 30 天下载量：3188（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：51（近 12 个月 0 个）

## 中文简介

现代地方发展的官方Beemo配置模块.

## 安装

```sh
npm install @beemo/dev
```

也可以使用：`pnpm add @beemo/dev`、`yarn add @beemo/dev`、`bun add @beemo/dev`

## README

# Beemo - 开发配置模块

[![Build Status](https://github.com/beemojs/dev/workflows/Build/badge.svg)](https://github.com/beemojs/dev/actions?query=branch%3Amaster) [![npm version](https://badge.fury.io/js/%40beemo%config-babel.svg)](https://www.npmjs.com/package/@beemo/config-babel) [![npm deps](https://david-dm.org/beemojs/dev.svg?path=packages/config-babel)](https://www.npmjs.com/package/@beemo/config-babel)

官方类型Script只包含“ 电池” Beemo [配置模块](https://beemo.dev/docs/provider) 提供了预装配置 Babel,ESLint,Jest,Prettier,以及TypeScript驱动器和开发工具.

```bash
yarn install --dev @beemo/dev
```

## 所需资源

-   源文件在一个名为 `src`。 。 。 .
-   测试文件在一个名为 `tests` 相对于来源,或 `__tests__` 在源码内.
-   声明/类型文件在一个名为 `types` 相对来源.
-   自定义类型脚本路径应该从 `:` 改为 `@` 为避免 [国家预防机制供应链攻击](https://github.blog/2021-02-12-avoiding-npm-substitution-attacks/)。 。 。 .

## 设置

创建一个 `.config/beemo.ts` 在工程的根中配置文件 `@beemo/dev` 作为 配置模块. 确保启用所有驱动器和任何设置 .

```ts
// .config/beemo.ts
export default {
    module: '@beemo/dev',
    drivers: ['babel', 'eslint', 'jest', 'prettier', 'typescript'],
    settings: {},
};
```

### 设置

以下的比莫 `settings` 可以定义,并将传递给适用的驱动程序.

-   `decorators` (单位:千美元)`boolean`) - 为 Babel 和 TypeScript 驱动程序启用装饰器. 默认为 `false`。 。 。 .
-   `esm` (单位:千美元)`boolean`) - 启用ECMAScript模块"mode"用于支持它的工具(Babel,Jest等).
-   `node` (单位:千美元)`boolean`) - 当前项目将瞄准Node.js而不是浏览器. 默认为 `false`。 。 。 .
-   `projects` (单位:千美元)`boolean | string[]`——启用Jest项目. 若为 `true` 将会解决 使用工作空间,否则需要一系列明确的字符串. 默认为 `false`。 。 。 .
-   `react` (单位:千美元)`boolean | classic | automatic`\- 为所有司机启用反应和JSX支持。 默认 改为 `false`。 。 。 .

### 覆盖

如果您想要覆盖驱动程序配置, 请创建 `.config/beemo/<driver>.ts` 根中的文件 (b) 执行项目. [查看官方的 Beemo 文件以获取更多信息](https://beemo.dev/docs/consumer#overriding-configs)。 。 。 .

```ts
// .config/beemo/eslint.ts
export default {
    rules: {
        'no-param-reassign': 'off',
    },
};
```

## 司机

在此配置模块中直接支持以下驱动程序, 并自动通过 运行时常见命令行选项.

-   [宝贝](https://www.npmjs.com/package/@beemo/config-babel)
    -   总是通过 `--copy-files`。 。 。 .
    -   设定 `--extensions` 对所有联合来文/技术服务延期.
    -   如果未提供退出,则默认为 `src/ --out-dir lib/`。 。 。 .
-   [ESLint 语录](https://www.npmjs.com/package/@beemo/config-eslint)
    -   总是通过 `--cache --color --fix`。 。 。 .
    -   设定 `--extensions` 对所有联合来文/技术服务延期.
    -   如果未提供目标, 默认会关闭 `src/ tests/`。 。 。 .
    -   如果使用工作空间,将在每个软件包中针对以上内容.
    -   启用时生成 Pretier 和 TypeScript 配置 .
-   [欢乐](https://www.npmjs.com/package/@beemo/config-jest)
    -   总是通过 `--colors --logHeapUsage`。 。 。 .
    -   设定 `NODE_ENV=test` 财务报告和审定财务报表 `TZ=UTC`。 。 。 .
    -   启用时生成 Babel 配置 .
    -   支助项目 `projects` 设置.
-   [高级](https://www.npmjs.com/package/@beemo/config-prettier)
    -   如果没有提供参数,则默认为 `--write .`。 。 。 .
    -   提供默认忽略常见文件列表 .
-   [类型脚本](https://www.npmjs.com/package/@beemo/config-typescript)
    -   现代/后续ECMAScript支持.
    -   只检查类型 .

> 请查阅文件,了解如何配置每个文件.

## 脚手架

一旦您的项目被配置为使用 Beemo, 您可以使用我们 内建模板.

### 项目/点文件

将脚手架常见的点文件像 `.gitignore`。 。 。 .

```
beemo scaffold project dotfiles
```

### 项目/基图布

将脚手架 GitHub 仓库工作流程文件到 `.github`。支持下列工作流程:

-   `build` - 构建、测试、用意和类型检查每个牵引请求和主机合并的项目. 还验证 [软件包](https://packemon.dev/) 包装和包装 [多龙](https://docusaurus.io/) 建筑通行证.
-   `deploy` - 部署a [多克龙网站](https://docusaurus.io/docs/deployment#deploying-to-github-pages) 每个 师承. 要求数 `GH_USER` 财务报告和审定财务报表 `GH_PAGES_DEPLOY` 秘密,我们有秘密.
-   `pr` - 使用 [常规变换日志-比莫](https://github.com/beemojs/conventional-changelog-beemo) 预设.

```
beemo scaffold project github
```

### 项目/包装

将字段附加到根 `package.json`。 。 。 .

-   添加数 `scripts` 共同行动 [大楼](https://packemon.dev/),倒接,测试等.
-   当通过时 `--workspaces`组合 `private` 财务报告和审定财务报表 `workspaces` 改为 `packages/*`。 。 。 .

```
beemo scaffold project package
```

### 工作空间/包装

将脚手架将一个新包装入一个 `packages` 工作空间。 创建 `CHANGELOG.md`, (中文(简体) ), `README.md`, (中文(简体) ), `LICENSE`,以及 `package.json` 文档.

```
beemo scaffold workspace package --owner milesj --repo aesthetic framework
```

## 常见问题

### @beemo/dev 是什么？

现代地方发展的官方Beemo配置模块\.

### 如何安装 @beemo/dev？

在项目目录运行 npm install @beemo/dev，或使用 pnpm add / yarn add / bun add。

### @beemo/dev 支持 TypeScript 吗？

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

### @beemo/dev 支持 ESM 还是 CommonJS？

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

### @beemo/dev 需要什么版本的 Node\.js？

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

### @beemo/dev 可以商用吗？

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

### @beemo/dev 的下载量有多少？

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

### @beemo/dev 还在维护吗？

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