# @ckeditor/ckeditor5-dev-env 中文文档

规范地址：https://npmcn.com/package/%40ckeditor/ckeditor5-dev-env/

版本：31\.1\.13
npm 元数据更新时间：2022-12-20T12:16:23.013Z
中文译文更新时间：2026-11-09T23:23:17.039Z
软件包许可：GPL-2\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40ckeditor/ckeditor5-dev-env
原文对照：https://npmcn.com/package/%40ckeditor/ckeditor5-dev-env/?lang=original
项目主页：https://github.com/ckeditor/ckeditor5-dev/tree/master/packages/ckeditor5-dev-env
源码仓库：https://github.com/ckeditor/ckeditor5-dev

弃用说明：This package is no longer maintained\. Please, read the migration path: https://github\.com/ckeditor/ckeditor5-dev/releases/tag/v32\.0\.0\.

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

- 包体积（解压后）：215 kB，42 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.0\.0
- 运行依赖：23 个
- 首次发布：2016-08-23T12:45:42.639Z
- 最新版本发布：2022-11-25T11:05:23.166Z
- 近 30 天下载量：10137（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：181（近 12 个月 0 个）

## 中文简介

CKEditor 5. 开发过程中使用的任务.

## 安装

```sh
npm install @ckeditor/ckeditor5-dev-env
```

也可以使用：`pnpm add @ckeditor/ckeditor5-dev-env`、`yarn add @ckeditor/ckeditor5-dev-env`、`bun add @ckeditor/ckeditor5-dev-env`

## README

# CKEditor 5 开发环境任务

[![npm version](https://badge.fury.io/js/%40ckeditor%2Fckeditor5-dev-env.svg)](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-env) [![Build Status](https://travis-ci.com/ckeditor/ckeditor5-dev.svg?branch=master)](https://app.travis-ci.com/github/ckeditor/ckeditor5-dev) ![Dependency Status](https://img.shields.io/librariesio/release/npm/@ckeditor/ckeditor5-dev-env)

开发过程中使用的任务 [电脑编辑 5](https://ckeditor.com/)。 。 。 .

有关开发工具包的更多信息可在以下 URL 找到: [https://github.com/ckeditor/ckeditor5-dev 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/ckeditor/ckeditor5-dev)。 。 。 .

## 发布工具

### 使用量

```
npm i --save-dev @ckeditor/ckeditor5-dev-env
```

然后创建运行任务的脚本 :

```js
// scripts/changelog-self.js: Generate changelog for the current package.
require( '@ckeditor/ckeditor5-dev-env' ).generateChangelogForSinglePackage();
```

```js
// scripts/changelog-repos.js: Generate changelog for all dependencies (repository using multiple repositories).
require( '@ckeditor/ckeditor5-dev-env' ).generateChangelogForSubRepositories( /* options */ );

// See the `options` argument:
// https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-env/lib/release-tools/tasks/generatechangelogforsubrepositories.js#L20-L27
```

```js
// scripts/changelog-packages.js: Generate changelog for all packages (repository contains multiple packages).
require( '@ckeditor/ckeditor5-dev-env' ).generateChangelogForSubPackages( /* options */ );

// See the `options` argument:
// https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-env/lib/release-tools/tasks/generatechangelogforsubpackages.js#L20-L27
```

```js
// scripts/release-bump-versions.js: Validates and updates version for all packages (includes the package found in options.cwd)
require( '@ckeditor/ckeditor5-dev-env' ).bumpVersions( /* options */ );

// See the `options` argument:
// https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-env/lib/release-tools/tasks/bumpversions.js#L20-L27
```

```js
// scripts/release-packages.js: Publish all changes.
require( '@ckeditor/ckeditor5-dev-env' ).releaseSubRepositories( /* options */ );

// See the `options` argument:
// https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-env/lib/release-tools/tasks/releasesubrepositories.js#L20-L27
```

### 生成更改日志

这个工具可以根据寄存器中的承诺生成一个更改日志文件. 它还可以提出下一个发行版本应该是什么(根据《公约》第2条) [交换器](http://semver.org/)) (中文(简体) ).

更多关于 [git 承诺消息公约](https://github.com/ckeditor/ckeditor5-design/wiki/Git-commit-message-convention) 由本工具执行.

### 为多个寄存器创建释放

**说明:** 在运行缓冲版本任务之前,您需要生成更改日志,用于发布版本中的更改.

工具实施的进程:

1.  从更改日志( 上一个标题) 读取新发行版本 ,
2.  过滤不会释放的软件包(没有更改或依赖性没有改变),
3.  更新新版本的软件包 `package.json` 对所有发布的软件包,
4.  提交这些更改为 `Release: vX.Y.Z.`, (中文(简体) ),
5.  创建标签 `vX.Y.Z`。 。 。 .

### 出版变更

**说明:** 在发布更改之前, 您需要在所有依赖性中突起版本 .

工具实施的进程:

1.  比较在国家预防机制和GitHub上发布的版本。 在此基础上,该工具知道应该出版什么。 你可以多次调用相同的脚本,没有出错.
2.  如果选择在国家预防机制上发布:该工具发布国家预防机制的变化.
3.  如果选择在 GitHub 上发布: 工具创建一个 [GitHub 发布](https://help.github.com/articles/creating-releases/)。释放的注释取自更改日志.
4.  如果没有选择任何内容: 工具无所作为 。 不发表,不推,不创建发行.

## 翻译工具

可用任务 :

-   `collect` - 收集翻译字符串(从 `t()` )并把它们存储在ckeditor5/build/.transifex目录中.
-   `upload` - 从收集的文件上传翻译到Transifex.
-   `download` - 从Transifex下载每个软件包和语言的翻译.

### 使用量

```
npm i --save-dev @ckeditor/ckeditor5-dev-env
```

然后使用 `ckeditor5-dev-env-translations` 命令 :

```
# directly from command line:
node ./node_modules/bin/ckeditor5-dev-env-translations collect

# using npx:
npx ckeditor5-dev-env-translations collect
```

或加进 `package.json` 脚本 :

```
{
  "scripts": {
    "translations:collect": "ckeditor5-dev-env-translations collect",
    "translations:download": "ckeditor5-dev-env-translations download",
    "translations:upload": "ckeditor5-dev-env-translations upload"
  }
}
```

## 更改日志

见 [`CHANGELOG.md`](https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-env/CHANGELOG.md) 文档.

## 许可证

根据下列规定获得许可证: [GNU 通用公共许可证版本 2 或稍后版本](http://www.gnu.org/licenses/gpl.html)请检查date=中的日期值 (帮助) `LICENSE.md` 文档.

## 常见问题

### @ckeditor/ckeditor5-dev-env 是什么？

CKEditor 5\. 开发过程中使用的任务\.注意：该包已被作者标记为弃用——This package is no longer maintained\. Please, read the migration path: https://github\.com/ckeditor/ckeditor5-dev/releases/tag/v32\.0\.0\.

### 如何安装 @ckeditor/ckeditor5-dev-env？

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

### @ckeditor/ckeditor5-dev-env 支持 TypeScript 吗？

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

### @ckeditor/ckeditor5-dev-env 支持 ESM 还是 CommonJS？

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

### @ckeditor/ckeditor5-dev-env 需要什么版本的 Node\.js？

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

### @ckeditor/ckeditor5-dev-env 可以商用吗？

@ckeditor/ckeditor5-dev-env 使用 GPL-2\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @ckeditor/ckeditor5-dev-env 的下载量有多少？

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

### @ckeditor/ckeditor5-dev-env 还在维护吗？

最新版本 31\.1\.13 发布于 2022/11/25（3 年前）；至今共发布 181 个版本，其中过去 12 个月发布了 0 个；首次发布于 2016/08/23。作者已将其标记为弃用，新项目建议寻找替代方案。

