# @\_sh/strapi-plugin-ckeditor 中文文档

规范地址：https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/

版本：8\.0\.0
npm 元数据更新时间：2026-08-09T22:43:52.822Z
中文译文更新时间：2026-11-05T17:47:12.924Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40_sh/strapi-plugin-ckeditor
原文对照：https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/?lang=original
项目主页：https://community.strapi.io/marketplace/sh-strapi-plugin-ckeditor
源码仓库：https://github.com/nshenderov/strapi-plugin-ckeditor

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

- 包体积（解压后）：160 kB，43 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0 \<=26\.x\.x
- 运行依赖：4 个
- peer 依赖：@strapi/design-system ^2\.0\.0，@strapi/icons ^2\.0\.0，@strapi/strapi ^5\.0\.0，react ^18\.0\.0，react-dom ^18\.0\.0，react-router-dom ^6\.0\.0，styled-components ^6\.0\.0
- 首次发布：2022-04-28T04:26:55.300Z
- 最新版本发布：2026-08-09T22:43:52.711Z
- 近 30 天下载量：143908（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 4 个）

## 中文简介

将 CKEditor 5 作为完全定制的自定义字段纳入您的 Strapi 项目中 。 (社区版)

## 安装

```sh
npm install @_sh/strapi-plugin-ckeditor
```

也可以使用：`pnpm add @_sh/strapi-plugin-ckeditor`、`yarn add @_sh/strapi-plugin-ckeditor`、`bun add @_sh/strapi-plugin-ckeditor`

## README

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-head.png)

# (原始内容存档于2018-09-26). Strapi QQ CKEditor

将 CKEditor 5 作为完全定制的自定义字段纳入您的 Strapi 项目中 。 (社区版)

## 开始吧

-   [特征](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-features)
-   [安装](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-installation)
-   [使用量](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-usage)
-   [配置](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-configuration)
-   [捐款](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-contributing)
-   [移徙](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-migration)
-   [所需资源](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-requirements)
-   [解决问题](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-troubleshooting)

## \* 特性

-   **广泛配置**
-   **媒体图书馆整合**
-   **黑暗主题支持**
-   **全屏扩展**
-   **响应图像支持**
-   **自动 UI 翻译**
-   **i18n 支持**
-   **自我拥有**

[![Buy Me A Coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://boosty.to/nkshenderov/donate)

## \* 安装

**斯特拉皮 v5 :**

将软件包添加到您的 Strapi 应用程序 :

```bash
yarn add @_sh/strapi-plugin-ckeditor
```

然后,构建应用程序:

```bash
yarn build
```

**斯特拉皮 v4 :**

插件的第3版将保留给Strapi v4,直到2026年3月. 参见 [**v3 安装指南**](https://github.com/nshenderov/strapi-plugin-ckeditor/blob/3.x.x/README.md#installation) 用于设置指令.

> 注: 第3版只接收必需的bug修正. 配置过程和可用 第3版的特性与最新的插件版本有很大不同.

## 使用量

字段可见于“内容-类型构建器”下 `CUSTOM` 选项卡:

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-usage-guide-2.png)

**预设**

预设是一组定义编辑器特征和外观的设置. 你个 可以指定每个字段的专用预设。 可用的预设可以通过 [配置](https://npmcn.com/package/%40_sh/strapi-plugin-ckeditor/#readme-configuration)。 。 。 .

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-usage-guide-3.png)

插件提供了框外的两个预设: `Default HTML editor` 财务报告和审定财务报表 `Default Markdown editor`, (中文(简体) ), 每个都具有不同的输出格式:HTML和Markdown分别. 两个预设包括: 一套广泛的非先质 CKEditor 插件.

默认 HTML 编辑器 :

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-def-html-dark.png)

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-def-html-light.png)

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-def-html-light-full.png)

默认 Markdown 编辑器 :

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-def-mrk-dark.png)

![](https://raw.githubusercontent.com/nshenderov/strapi-plugin-ckeditor/master/assets/v5-def-mrk-light.png)

**响应图像**

插件生成 `srcset` 如果插入的图像有属性 `formats` 其他 `thumbnail`。 。 。 .

**UI 语言**: 如果你不在编辑器配置中指定用户界面语言,插件将 默认为 Strapi 管理员首选语言 。 如果没有设置首选,英语将被用作倒置.

**内容语言**: i18n 对于编辑器的内容语言,可以通过检查 `Enable localization for this field` 选项卡.

> QQ 在您的应用程序的出版方面使用内容样式很重要 。 否则,内容会在编辑器和你的终端用户中看起来不同. [遵循文件](https://ckeditor.com/docs/ckeditor5/latest/getting-started/setup/css.html#styling-the-published-content)。 。 。 .

> 要在您的管理面板上显示来自外部来源的内容, 如图像或视频, 您需要配置您的 `middlewares.js` 文档. [**检查文档的细节.**](https://docs.strapi.io/dev-docs/configurations/middlewares#security)

## QQ 配置

插件配置必须在前端定义 .

插件提供了一组功能,允许您修改插件的配置 :

```ts
setPluginConfig(config);
getPluginPresets();
getPluginTheme();
```

**设置 Plugin 配置**

函数,接受插件配置(`PluginConfig`)可以包括一系列预设 和一个主题对象 :

```ts
import { setPluginConfig } from '@_sh/strapi-plugin-ckeditor';

function setPluginConfig(pluginConfig: {
  presets: Preset[] | undefined;
  theme: Theme | undefined;
}): void;
```

**要点:**

-   该函数必须在管理员面板的靴子陷阱生命周期函数前被引用. 一般性建议是在行政小组的登记寿命周期功能内使用.
-   如果属性将覆盖默认配置值 .
-   这种配置在第一次引用后变得不可改变,防止了进一步的修改.

**插件配置对象** 包含可选 `presets` 财务报告和审定财务报表 `theme` 属性 :

```ts
type PluginConfig = {
  /**
   * Presets are sets of settings that define the editor's features and appearance.
   */
  presets?: Preset[];
  /**
   * Styles applied globally to every editor instance.
   */
  theme?: Theme;
};
```

`presets` 是类型对象的数组 `Preset`。每个预设包含以下属性:

```ts
type Preset = {
  /**
   * Preset name, displayed in the schema.
   */
  name: string;
  /**
   * Preset description, displayed in the Content-Type Builder.
   */
  description: string;
  /**
   * CKEditor configuration object.
   *
   * @see {@link https://ckeditor.com/docs/ckeditor5/latest/getting-started/setup/configuration.html | CKEditor documentation}
   */
  editorConfig: EditorConfig;
  /**
   * Additional styles applied to the editor instance after the theme styles.
   */
  styles?: EditorStyles;
};
```

`theme` 对象定义适用于每个编辑器实例的插件 CSS 样式。 它包括 以下属性 :

```ts
/**
 * The `common` styles are applied first, followed by `light` or `dark` styles
 * according to user preferences, and finally `additional` styles.
 */
type Theme = {
  /**
   * Core styles.
   */
  common?: EditorStyles;
  /**
   * Styles applied in light mode.
   */
  light?: EditorStyles;
  /**
   * Styles applied in dark mode.
   */
  dark?: EditorStyles;
  /**
   * Additional styles that complement the theme.
   */
  additional?: EditorStyles;
};
```

```ts
/**
 * Represents styles that can be applied to an editor instance.
 * Can be a plain CSS string or an array of interpolations for dynamic styling.
 */
export type EditorStyles = string | Interpolation<object>[];
```

**获取 Plugin 预设**

```ts
function getPluginPresets(): {
  [key: string]: Preset;
};
```

回返 `presets` 对象.

-   每个属性名称必须匹配相应的预设名称.
-   要扩展或修改管理员面板内容管理器中可见的选项, 在管理面板的靴子陷阱生命周期功能之前必须进行修改.

**获得悬浮主题**

```ts
function getPluginTheme(): Theme;
```

回返 `theme` 对象.

**默认预设和主题**

为了简化定义新预设的过程,插件导出默认预设和 默认主题,可以在自定义配置中用作基础:

```ts
import {
  defaultTheme,
  defaultHtmlPreset,
  defaultMarkdownPreset,
} from '@_sh/strapi-plugin-ckeditor';
```

**与 Strapi 的媒体库合并**

要将 CKEditor 与 Strapi 的媒体库整合, 插件提供了两个 CKEditor 插件 ,可以在不添加配置的情况下包含在预设中:

```ts
import { StrapiMediaLib, StrapiUploadAdapter } from '@_sh/strapi-plugin-ckeditor';
```

**可用类型定义**

以下类型定义可供使用:

```ts
import type {
  PluginConfig,
  Preset,
  EditorConfig,
  Theme,
  EditorStyles,
} from '@_sh/strapi-plugin-ckeditor';
```

类型定义

```ts
/**
 * Plugin configuration object.
 */
export type PluginConfig = {
  /**
   * Presets are sets of settings that define the editor's features and appearance.
   */
  presets?: Preset[];
  /**
   * Styles applied globally to every editor instance.
   */
  theme?: Theme;
};
```

```ts
/**
 * Preset is a set of settings that define the editor's features and appearance.
 */
export type Preset = {
  /**
   * Preset name, displayed in the schema.
   */
  name: string;
  /**
   * Preset description, displayed in the Content-Type Builder.
   */
  description: string;
  /**
   * Additional styles applied to the editor instance after the theme styles.
   */
  styles?: EditorStyles;
  /**
   * CKEditor configuration object.
   *
   * @see {@link https://ckeditor.com/docs/ckeditor5/latest/getting-started/setup/configuration.html | CKEditor documentation}
   */
  editorConfig: EditorConfig;
};
```

```ts
/**
 * CKEditor configuration object.
 *
 * @see {@link https://ckeditor.com/docs/ckeditor5/latest/getting-started/setup/configuration.html | CKEditor documentation}
 */
export type EditorConfig = CKE5EditorConfig;
```

```ts
/**
 * Styles applied globally to every editor instance.
 *
 * @remarks
 *
 * The `common` styles are applied first, followed by `light` or `dark` styles
 * according to the preferences, and finally `additional` styles.
 */
export type Theme = {
  /**
   * Core styles.
   */
  common?: EditorStyles;
  /**
   * Styles applied in light mode.
   */
  light?: EditorStyles;
  /**
   * Styles applied in dark mode.
   */
  dark?: EditorStyles;
  /**
   * Additional styles that complement the theme.
   */
  additional?: EditorStyles;
};
```

```ts
/**
 * Represents styles that can be applied to an editor instance.
 * Can be a plain CSS string or an array of interpolations for dynamic styling.
 */
export type EditorStyles = string | Interpolation<object>[];
```

### 配置实例 :

设置一套新的预设 \[JS\]

```js
// src/admin/app.js

import {
  Bold,
  Italic,
  Essentials,
  Heading,
  Image,
  ImageCaption,
  ImageStyle,
  ImageToolbar,
  ImageUpload,
  Link,
  List,
  Paragraph,
} from 'ckeditor5';

import { setPluginConfig, StrapiMediaLib, StrapiUploadAdapter } from '@_sh/strapi-plugin-ckeditor';

const myCustomPreset = {
  name: 'myCustomPreset',
  description: 'myCustomPreset description',
  editorConfig: {
    licenseKey: 'GPL',
    plugins: [
      Bold,
      Italic,
      Essentials,
      Heading,
      Image,
      ImageCaption,
      ImageStyle,
      ImageToolbar,
      ImageUpload,
      Link,
      List,
      Paragraph,
      StrapiMediaLib,
      StrapiUploadAdapter,
    ],
    toolbar: [
      'heading',
      '|',
      'bold',
      'italic',
      'link',
      'bulletedList',
      'numberedList',
      '|',
      'strapiMediaLib',
      '|',
      'undo',
      'redo',
    ],
  },
};

const myConfig = {
  /**
   * Note: Since the provided `presets` include only `myCustomPreset`
   * this configuration will overwrite default presets.
   */
  presets: [myCustomPreset],
};

export default {
  register() {
    setPluginConfig(myConfig);
  },
};
```
设置一套新的预设 \[TS\]

```ts
// src/admin/app.ts

import {
  Bold,
  Italic,
  Essentials,
  Heading,
  Image,
  ImageCaption,
  ImageStyle,
  ImageToolbar,
  ImageUpload,
  Link,
  List,
  Paragraph,
} from 'ckeditor5';

import {
  type PluginConfig,
  type Preset,
  setPluginConfig,
  StrapiMediaLib,
  StrapiUploadAdapter,
} from '@_sh/strapi-plugin-ckeditor';

const myCustomPreset: Preset = {
  name: 'myCustomPreset',
  description: 'myCustomPreset description',
  editorConfig: {
    licenseKey: 'GPL',
    plugins: [
      Bold,
      Italic,
      Essentials,
      Heading,
      Image,
      ImageCaption,
      ImageStyle,
      ImageToolbar,
      ImageUpload,
      Link,
      List,
      Paragraph,
      StrapiMediaLib,
      StrapiUploadAdapter,
    ],
    toolbar: [
      'heading',
      '|',
      'bold',
      'italic',
      'link',
      'bulletedList',
      'numberedList',
      '|',
      'strapiMediaLib',
      '|',
      'undo',
      'redo',
    ],
  },
};

const myConfig: PluginConfig = {
  /**
   * Note that since provided `presets` includes only `myCustomPreset`
   * this configuration will overwrite default presets.
   */
  presets: [myCustomPreset],
};

export default {
  register() {
    setPluginConfig(myConfig);
  },
};
```
使用 PluginConfig 的默认预设修改

```ts
// src/admin/app.ts

import { css } from 'styled-components';

import {
  type PluginConfig,
  type Preset,
  setPluginConfig,
  defaultHtmlPreset,
  defaultMarkdownPreset,
} from '@_sh/strapi-plugin-ckeditor';

const defaultHtml: Preset = {
  ...defaultHtmlPreset,
  description: 'Modified default HTML editor',
  styles: `
    .ck { 
      color: red; 
    }
  `,
  editorConfig: {
    ...defaultHtmlPreset.editorConfig,
    placeholder: 'Modified default HTML editor',
    toolbar: [
      'heading',
      '|',
      'bold',
      'italic',
      'link',
      'bulletedList',
      'numberedList',
      '|',
      'strapiMediaLib',
      'insertTable',
      '|',
      'undo',
      'redo',
    ],
  },
};

const defaultMarkdown: Preset = {
  ...defaultMarkdownPreset,
  description: 'Modified default Markdown editor',
  styles: css`
    .ck {
      --ck-editor-max-width: 1500px;
      --ck-editor-min-height: 700px;
      --ck-editor-max-height: 700px;
    }

    .ck.ck-editor__main {
      border: 3px dashed ${({ theme }) => theme.colors.warning500};
    }
  `,
};

const myConfig: PluginConfig = {
  presets: [defaultHtml, defaultMarkdown],
};

export default {
  register() {
    setPluginConfig(myConfig);
  },
};
```
使用 getPluginPresets 默认预设修改 \[TS\]

```ts
// src/admin/app.ts

import { css } from 'styled-components';
import { getPluginPresets } from '@_sh/strapi-plugin-ckeditor';

export default {
  register() {
    const presets = getPluginPresets();

    presets.defaultHtml.styles = css`
      .ck {
        color: red;
      }
    `;

    presets.defaultHtml.editorConfig = {
      ...presets.defaultHtml.editorConfig,
      placeholder: 'Modified default HTML editor',
      toolbar: [
        'heading',
        '|',
        'bold',
        'italic',
        'link',
        'bulletedList',
        'numberedList',
        '|',
        'strapiMediaLib',
        'insertTable',
        '|',
        'undo',
        'redo',
      ],
    };

    presets.defaultMarkdown = {
      ...presets.defaultMarkdown,
      description: 'Modified default Markdown editor',
      styles: css`
        .ck {
          --ck-editor-max-width: 1500px;
          --ck-editor-min-height: 700px;
          --ck-editor-max-height: 700px;
        }

        .ck.ck-editor__main {
          border: 3px dashed ${({ theme }) => theme.colors.warning500};
        }
      `,
    };
  },
};
```
使用设置 PluginConfig 修改主题

```ts
// src/admin/app.ts

import { css } from 'styled-components';

import { type PluginConfig, setPluginConfig, defaultTheme } from '@_sh/strapi-plugin-ckeditor';

const myConfig: PluginConfig = {
  theme: {
    ...defaultTheme,
    additional: css`
      .ck {
        --ck-editor-max-width: 1500px;
        --ck-editor-min-height: 700px;
        --ck-editor-max-height: 700px;
      }

      .ck.ck-editor__main {
        border: 3px dashed ${({ theme }) => theme.colors.warning500};
      }
    `,
  },
};

export default {
  register() {
    setPluginConfig(myConfig);
  },
};
```
使用 GetPlugin Theme 修改主题 \[TS\]

```ts
// src/admin/app.ts

import { css } from 'styled-components';
import { getPluginTheme } from '@_sh/strapi-plugin-ckeditor';

export default {
  register() {
    const theme = getPluginTheme();

    theme.additional = css`
      .ck {
        --ck-editor-max-width: 1500px;
        --ck-editor-min-height: 700px;
        --ck-editor-max-height: 700px;
      }

      .ck.ck-editor__main {
        border: 3px dashed ${({ theme }) => theme.colors.warning500};
      }
    `;
  },
};
```
添加时间戳插件 \[JS\]

```ts
// src/admin/app.js

import { Plugin, ButtonView } from 'ckeditor5';

import { setPluginConfig, defaultHtmlPreset } from '@_sh/strapi-plugin-ckeditor';

class Timestamp extends Plugin {
  init() {
    const editor = this.editor;
    editor.ui.componentFactory.add('timestamp', () => {
      const button = new ButtonView();
      button.set({
        label: 'timestamp',
        withText: true,
      });
      button.on('execute', () => {
        const now = new Date();
        editor.model.change(writer => {
          editor.model.insertContent(writer.createText(now.toString()));
        });
      });
      return button;
    });
  }
}

export default {
  register() {
    defaultHtmlPreset.editorConfig.plugins.push(Timestamp);
    defaultHtmlPreset.editorConfig.toolbar.unshift('timestamp');
    setPluginConfig({ presets: [defaultHtmlPreset] });
  },
};
```
  

默认 HTML 预设 : [**admin/src/config/html 预设.ts**](https://github.com/nshenderov/strapi-plugin-ckeditor/blob/master/admin/src/config/htmlPreset.ts)

默认标记预设 : [**admin/src/config/markdown 预设.ts**](https://github.com/nshenderov/strapi-plugin-ckeditor/blob/master/admin/src/config/markdownPreset.ts)

默认主题 : [**管理/事务/主题**](https://github.com/nshenderov/strapi-plugin-ckeditor/blob/master/admin/src/theme)

> \* 高度建议探讨 [**cKEditor5 官方文档**](https://ckeditor.com/docs/ckeditor5/latest/getting-started/setup/configuration.html)。 。 。 .

## 捐款

随便你 [叉子存储器](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) 并且打开拉动请求,任何帮助都会得到感谢.

遵循这些步骤建立插件开发环境. 注意开发插件 需要节点 **第22页**,尽管已发布的软件包支持节点 20,因为 Strapi 插件SDK的工具链不再运行于节点20上.

1.  克隆仓库.
    
2.  读取 [strapi 插件 SDK 文档](https://docs.strapi.io/dev-docs/plugins/development/create-a-plugin#linking-the-plugin-to-your-project)。 。 。 .
    
3.  导航到已复制的插件文件夹并安装依赖, 运行 :
    

```bash
yarn install
```

4.  将插件链接到您的工程 :
    
    -   在插件文件夹中, 运行 :
    
    ```bash
    yarn watch:link
    ```
    
    -   打开新终端, 导航您的 Strapi 项目目录, 然后运行 :
    
    ```bash
    yarn dlx yalc add --link @_sh/strapi-plugin-ckeditor && yarn install
    ```
    
5.  重建工程并启动服务器 :
    

```bash
yarn build
yarn develop
```

## \* 移徙

要升级到最新版本,请遵循专辑 [移徙指南](https://github.com/nshenderov/strapi-plugin-ckeditor/blob/master/MIGRATION.md) 详细指示.

## 所需经费

**v8.x.x (中文(简体) )**

斯特拉皮语Name **页:1**

节点 **\>= 20.0.0 <= 26.x.x**

* * *

**v5.x.x - v7.x.x (英语)**

斯特拉皮语Name **页:1**

节点 **\>= 20.0.0 <= 24.x.x**

* * *

**v3.x.x (英语)**

斯特拉皮语Name **\>= 4.13.0 < 5.0.0**

节点 **\>= 18.0.0 <= 20.x.x**

## \* 解决问题

### Strapi 5.51.x上的空白管理员面板

Strapi 5.51.0 添加了从Vite 的依赖性中移除这种插件的热度 预分解. 没有预捆绑, 插件依赖树中的 CommunityJS 软件包会被服务 切入到浏览器 as- is, 而本地的无害环境管理无法装入 。 管理面板将空白页和 控制台显示错误, 如 :

```
The requested module '/admin/node_modules/property-expr/index.js'
does not provide an export named 'getter'
```

这只会影响 `strapi develop`生产结构 `strapi build` 不受影响, 因为它不使用依赖性预捆绑.

固定在上游 [皮带/斯特拉皮# 27136](https://github.com/strapi/strapi/issues/27136) 合并于 [皮带/斯特拉皮#27264](https://github.com/strapi/strapi/pull/27264)直到它降落在 ,将插件放回您 Strapi 项目的预捆绑路径:

```ts
// src/admin/vite.config.ts
import type { UserConfig } from 'vite';

const KEEP_PREBUNDLED = ['@_sh/strapi-plugin-ckeditor', '@ckeditor/ckeditor5-react'];

export default (config: UserConfig) => {
  config.optimizeDeps = config.optimizeDeps ?? {};
  config.optimizeDeps.exclude = (config.optimizeDeps.exclude ?? []).filter(
    dep => !KEEP_PREBUNDLED.includes(dep)
  );

  return config;
};
```

然后清除缓存并重新启动:

```bash
rm -rf .strapi node_modules/.strapi
```

需要两个软件包名称。 仅用第一个 管理员面板加载但编辑器 没有,没有 `Failed to resolve import "@ckeditor/ckeditor5-react"`。 。 。 .

一旦您升级到包含上游修正的 Strapi 发布器, 就删除此文件 .

## 常见问题

### @\_sh/strapi-plugin-ckeditor 是什么？

将 CKEditor 5 作为完全定制的自定义字段纳入您的 Strapi 项目中 。 \(社区版\)

### 如何安装 @\_sh/strapi-plugin-ckeditor？

在项目目录运行 npm install @\_sh/strapi-plugin-ckeditor，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@strapi/design-system（^2\.0\.0）、@strapi/icons（^2\.0\.0）、@strapi/strapi（^5\.0\.0）、react（^18\.0\.0）、react-dom（^18\.0\.0）、react-router-dom（^6\.0\.0）、styled-components（^6\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @\_sh/strapi-plugin-ckeditor 支持 TypeScript 吗？

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

### @\_sh/strapi-plugin-ckeditor 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @\_sh/strapi-plugin-ckeditor 需要什么版本的 Node\.js？

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

### @\_sh/strapi-plugin-ckeditor 可以商用吗？

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

### @\_sh/strapi-plugin-ckeditor 的下载量有多少？

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

### @\_sh/strapi-plugin-ckeditor 还在维护吗？

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