# @contentstack/core 中文文档

规范地址：https://npmcn.com/package/%40contentstack/core/

版本：1\.5\.4
npm 元数据更新时间：2026-11-02T09:29:37.089Z
中文译文更新时间：2026-11-10T16:42:54.386Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：294 kB，61 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2023-12-21T06:25:36.228Z
- 最新版本发布：2026-11-02T09:29:36.702Z
- 近 30 天下载量：149669（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 19 个）

## 中文简介

[![Contentstack](https://www.contentstack.com/docs/static/images/contentstack.png)](https://www.contentstack.com/)

## 安装

```sh
npm install @contentstack/core
```

也可以使用：`pnpm add @contentstack/core`、`yarn add @contentstack/core`、`bun add @contentstack/core`

## README

# @ contentstack/ core (中文(简体) )

[![Contentstack](https://www.contentstack.com/docs/static/images/contentstack.png)](https://www.contentstack.com/)

TypeScript Core SDK for Conturaltack - 一个基础库,为ConturalTypeScript SDKs提供核心模块和工具.

## 关于内容夹

内容tack是一种无头的CMS,采用API-First方法. 这是一个CMS,开发者可以用来用他们最喜爱的语言来构建强大的跨平台应用程序. 构建您的应用程序前端, 而Contack 将照顾其余的 . [更多信息](https://www.contentstack.com/)。 。 。 .

## 说明

这套软件包包含核心模块和供 [内存类型SDK](https://github.com/contentstack/contentstack-typescript/)它提供了基本的功能,包括HTTP客户端配置,错误处理,请求管理,参数序列化和重试政策.

## 特征

-   **HTTP 客户端**: 配置基于 Axios 的 HTTP 客户端, 支持自定义适配器
-   **处理错误**: API和Conturaltack特定错误的综合错误分类
-   **请求管理**: 请求处理截取器和自定义错误回调
-   **参数序列化**: API 请求的自定义参数序列化
-   **重试政策**: 内置处理速率限制和瞬间出错的重试逻辑
-   **类型脚本支持**: 包含全部类型脚本定义
-   **多重构建格式**: 支持通用JS、无害环境管理、UMD和类型脚本声明

## 重要说明

**此软件包是一个内部依赖** 由Contack TypeScript SDKs所使用. 最终用户应 **没有** 直接安装此软件包。 取而代之的是安装适当的Contack SDK(例如, [内存类型SDK](https://github.com/contentstack/contentstack-typescript/)页:1.

## SDK 开发者

如果您正在开发或维护一个Contentack SDK,并且需要直接使用这个核心包,您可以将它安装为依赖性:

```bash
npm install @contentstack/core
```

然后导入模块 :

```typescript
import {
  httpClient,
  // ... other exports
} from '@contentstack/core';
```

## 发展

### 先决条件

-   节点.js版本 4.4.7 或以后

### 设置

清除寄存器并安装依赖性 :

```bash
git clone https://github.com/contentstack/contentstack-js-core.git
cd contentstack-js-core
npm install
```

### 构建

构建所有输出格式(CommonJS、无害环境管理、UMD和TypeScript声明):

```bash
npm run build
```

构建特定格式 :

```bash
npm run build        # Build all
npm run build:cjs    # CommonJS
npm run build:esm    # ES Modules
npm run build:umd    # UMD
npm run build:types  # TypeScript declarations
```

### 测试

运行单元测试 :

```bash
npm run test
```

运行林入 :

```bash
npm run lint
```

### 包装

创建包式柏油球 :

```bash
npm run package
```

### 干净

清洁建筑文物:

```bash
npm run clean
```

## 许可证

这个项目根据麻省理工学院的许可证获得许可。 见 [LICENSE.txt (英语)](https://npmcn.com/package/%40contentstack/core/LICENSE.txt) 详细文件.

## 仓库

-   **GitHub 图像**数字 : [内容夹/内容夹-js-core](https://github.com/contentstack/contentstack-js-core)

## 相关项目

-   [内存类型SDK](https://github.com/contentstack/contentstack-javascript/)

## 支助

关于问题和专题请求,请访问 [GitHub 问题](https://github.com/contentstack/contentstack-js-core/issues) 页 次.

* * *

版权 (c)2016-2025 Contactack. 版权所有.

## 常见问题

### 如何安装 @contentstack/core？

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

### @contentstack/core 支持 TypeScript 吗？

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

### @contentstack/core 支持 ESM 还是 CommonJS？

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

### @contentstack/core 可以商用吗？

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

### @contentstack/core 的下载量有多少？

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

### @contentstack/core 还在维护吗？

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