# @azure/core-client 中文文档

规范地址：https://npmcn.com/package/%40azure/core-client/

版本：1\.11\.2
npm 元数据更新时间：2026-11-07T17:11:13.778Z
中文译文更新时间：2026-11-07T13:04:34.557Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40azure/core-client
原文对照：https://npmcn.com/package/%40azure/core-client/?lang=original
项目主页：https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/core/core-client/
源码仓库：https://github.com/Azure/azure-sdk-for-js

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

- 包体积（解压后）：1.4 MB，215 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：7 个
- 首次发布：2020-09-25T18:28:50.462Z
- 最新版本发布：2026-11-07T17:11:13.589Z
- 近 30 天下载量：89454232（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：463（近 12 个月 33 个）

## 中文简介

与自动响应生成的代码接口的核心库

## 安装

```sh
npm install @azure/core-client
```

也可以使用：`pnpm add @azure/core-client`、`yarn add @azure/core-client`、`bun add @azure/core-client`

## README

# JavaScript 的 Azure Core 服务客户端库

此库主要用于由 [自动恢复](https://github.com/Azure/Autorest) 财务报告和审定财务报表 [`autorest.typescript`](https://github.com/Azure/autorest.typescript)。 。 。 .

## 开始

### 目前得到支持的环境

-   [节点.js的LTS版本](https://github.com/nodejs/release#release-schedule)
-   Safari,Chrome,Edge,和Firefox的最新版本.

看我们的 [支助政策](https://github.com/Azure/azure-sdk-for-js/blob/main/SUPPORT.md) 更多细节.

### 安装

这个软件包主要用于生成的代码中,而无意被终端用户直接消耗.

## 关键概念

### 服务客户端

这是生成客户的共同基础类. 它提供了方法 `sendOperationRequest` 财务报告和审定财务报表 `sendRequest`。 。 。 .

`sendRequest` 仅使用 `Pipeline` (见 `@azure/core-rest-pipeline` 详细情况。 )

`sendOperationRequest` 被生成的代码用来使用 `OperationSpec` 财务报告和审定财务报表 `OperationArguments`。一个 `OperationSpec` 是描述此服务的OpenAPI/Swagger文件对请求要求的翻译.

### 创建 Client 管道

此方法用于创建 `Pipeline` 以进行系列化和去串行化的额外政策定制的例子。 大部分工作是将请求转换成一个服务所期望的正确的HTTP消息,再将HTTP响应有效载荷转换为服务OpenAPI规格文件所描述的响应形状.

### 映射器/ 创建序列器

`Mapper`s用于将数据编码并解码为HTTP头和正文. 它们描述了所有请求和反应领域。 参见: `OperationSpec`编号.

方法 `createSerializer` 创建一个 `Serializer` 用于完成在提出请求或处理答复时转换数据的大部分工作。 面对一系列 `Mapper`s和适当的 `OperationSpec` 它可以制造一个用户提供的HTTP请求对象,或者将HTTP响应对象转换为方便用户的形式.

## 今后的步骤

你可以在当地建立和运行测试 通过执行 `npm run test`。探索 [测试](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/core-client/test) 查看高级用途和公开课行为的文件夹.

学习更多关于 [类型Spec](https://typespec.io/) [`@azure-tools/typespec-ts`](https://github.com/Azure/typespec-azure/tree/main/packages/typespec-ts) 在此软件包上生成兼容客户端的发射器 .

## 解决问题

如果你在使用图书馆时遇到问题 请随意 [提交问题](https://github.com/Azure/azure-sdk-for-js/issues/new)。 。 。 .

## 捐款

如果您想为图书馆捐钱 请读一下 [贡献指南](https://github.com/Azure/azure-sdk-for-js/blob/main/CONTRIBUTING.md) 学习如何构建和测试密码.

## 常见问题

### @azure/core-client 是什么？

与自动响应生成的代码接口的核心库

### 如何安装 @azure/core-client？

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

### @azure/core-client 支持 TypeScript 吗？

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

### @azure/core-client 支持 ESM 还是 CommonJS？

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

### @azure/core-client 需要什么版本的 Node\.js？

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

### @azure/core-client 可以商用吗？

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

### @azure/core-client 的下载量有多少？

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

### @azure/core-client 还在维护吗？

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