# @devx-commerce/strapi 中文文档

规范地址：https://npmcn.com/package/%40devx-commerce/strapi/

版本：2\.0\.0-beta\.0
npm 元数据更新时间：2026-10-26T09:00:15.103Z
中文译文更新时间：2026-11-12T04:38:39.334Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40devx-commerce/strapi
原文对照：https://npmcn.com/package/%40devx-commerce/strapi/?lang=original

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

- 包体积（解压后）：106 kB，44 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- peer 依赖：qs ^6\.14\.0，@medusajs/ui 4\.1\.9，@medusajs/cli 2\.14\.2，@medusajs/icons 2\.14\.2，@medusajs/medusa 2\.14\.2，@medusajs/admin-sdk 2\.14\.2，@medusajs/framework 2\.14\.2，@medusajs/test-utils 2\.14\.2
- 首次发布：2025-05-20T09:57:32.980Z
- 最新版本发布：2026-05-19T09:27:27.476Z
- 近 30 天下载量：2967（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 1 个）

## 中文简介

Strapi 作为 CMS 的 Medusa 插件

## 安装

```sh
npm install @devx-commerce/strapi
```

也可以使用：`pnpm add @devx-commerce/strapi`、`yarn add @devx-commerce/strapi`、`bun add @devx-commerce/strapi`

## README

[![Medusa logo](https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg)](https://www.medusajs.com/)

# 美杜莎插件 - Strapi

#### [文档](https://docs.medusajs.com/) | [网站](https://www.medusajs.com/)

用于将 Strapi 作为 Medusa 的 CMS 执行插件

## 特征

-   美杜莎和斯特拉皮的无缝融合
-   您的电子商务商店的灵活内容管理
-   产品图像和资产的丰富媒体管理
-   QQ 以自定义字段和内容扩展产品信息
-   \* 万能商业无头建筑
-   • 美杜莎和斯特拉皮之间的自动同步

## 所需资源

此插件需要:

-   [美杜莎岛](https://docs.medusajs.com/) >= 2.8.0版本
-   [斯特拉皮 v5](https://docs.strapi.io/) (最近稳定)

## 安装

1.  安装插件 :

```bash
npm install @devx-commerce/strapi @strapi/client
# or
yarn add @devx-commerce/strapi @strapi/client
```

2.  将插件添加到您的 `medusa-config.js`数字 :

```js
const { defineConfig } = require("@medusajs/medusa"); // or "@medusajs/framework/utils"

module.exports = defineConfig({
  // ... other config
  plugins: [
    // ... other plugins,
    {
      resolve: "@devx-commerce/strapi",
      options: {
        base_url: process.env.STRAPI_URL,
        api_key: process.env.STRAPI_API_KEY,
      },
    },
  ],
});
```

## 设置

### 设置 Strapi

1.  如果您还没有安装 Strapi :

```bash
npx create-strapi-app@latest my-strapi-cms
```

2.  启动您的 Strapi 服务器 :

```bash
cd my-strapi-cms
npm run develop
```

3.  在 Strapi 创建 API 令牌 :
    
    -   转到 **设置 > API 键**
    -   创建新的全程访问符
    -   复制用于您美杜莎配置的代号
4.  在 Strapi 中创建产品和变体收藏 :
    
    -   在您的 Strapi 管理面板中, 去 **内容- 类型构建器**
    -   创建名为新收藏类型 **产品**
        -   添加一个 **标题** 字段(文本类型)
        -   添加一个 **系统编号** 字段(文本类型,唯一)
    -   创建另一个名为收藏类型 **备选案文**
        -   添加一个 **标题** 字段(文本类型)
        -   添加一个 **系统编号** 字段(文本类型,唯一)
    -   保存并发布您的新收藏类型
5.  为您的 Medusa 后端配置环境变量 :
    
    ```
    STRAPI_URL=http://localhost:1337
    STRAPI_API_KEY=your-api-token-here
    ```
    

### 同步数据

在安装和设置后,插件将自动:

-   在草原中修改产品、收藏和类别时创建和更新
-   在美杜莎和斯特拉皮之间同步产品、收藏和分类元数据
-   允许使用 Strapi 的内容类型扩展产品数据

## 使用量

一旦设置了插件,您可以使用 Strapi 的管理员面板在您的产品中添加丰富的内容并使用 Strapi API为您的存储前端获取此内容.

从美杜莎取取出产品内容的例子(带有斯特拉皮字段):

```js
// In your storefront
async function getProductContent(productId) {
  const response = await fetch(
    `${MEDUSA_BASE_URL}/store/products/${productId}?fields=cms_product.*`,
    {
      headers: {
        "x-publishable-api-key": STOREFRONT_PUBLISHABLE_API_KEY,
      },
    },
  );
  const data = await response.json();
  return data.data[0];
}
```

## 文档

-   [美杜莎文献](https://docs.medusajs.com/)
-   [Strapi 文档](https://docs.strapi.io/)
-   [插件指南](https://npmcn.com/package/%40devx-commerce/strapi/src/)

* * *

## 常见问题

### @devx-commerce/strapi 是什么？

Strapi 作为 CMS 的 Medusa 插件

### 如何安装 @devx-commerce/strapi？

在项目目录运行 npm install @devx-commerce/strapi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：qs（^6\.14\.0）、@medusajs/ui（4\.1\.9）、@medusajs/cli（2\.14\.2）、@medusajs/icons（2\.14\.2）、@medusajs/medusa（2\.14\.2）、@medusajs/admin-sdk（2\.14\.2）、@medusajs/framework（2\.14\.2）、@medusajs/test-utils（2\.14\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @devx-commerce/strapi 支持 TypeScript 吗？

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

### @devx-commerce/strapi 支持 ESM 还是 CommonJS？

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

### @devx-commerce/strapi 需要什么版本的 Node\.js？

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

### @devx-commerce/strapi 可以商用吗？

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

### @devx-commerce/strapi 的下载量有多少？

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

### @devx-commerce/strapi 还在维护吗？

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