# @aws-lite/client 中文文档

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

版本：0\.24\.1
npm 元数据更新时间：2026-10-16T20:28:58.656Z
中文译文更新时间：2026-11-07T09:33:11.956Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws-lite/client
原文对照：https://npmcn.com/package/%40aws-lite/client/?lang=original
项目主页：https://aws-lite.org/
源码仓库：https://github.com/aws-lite/aws-lite

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

- 包体积（解压后）：160 kB，19 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2023-09-08T02:07:00.315Z
- 最新版本发布：2026-10-16T20:28:58.286Z
- 近 30 天下载量：8492315（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：82（近 12 个月 6 个）

## 中文简介

简单、快、可扩展的 AWS 客户端

## 安装

```sh
npm install @aws-lite/client
```

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

## README

[![aws-lite](https://github.com/aws-lite/aws-lite.org/raw/main/public/img/aws-lite.svg)](https://aws-lite.org/)

> [`aws-lite`](https://aws-lite.org/) 简单,极快,可扩展的节点.js客户端与AWS服务交互.
> 
> (其误报也好
> 
> 你可以把它看作是AWS的JavaScript SDK的一种由社区驱动的替代品.

 [![GitHub CI status](https://github.com/aws-lite/aws-lite/workflows/Node%20CI/badge.svg)](https://github.com/aws-lite/aws-lite/actions/workflows/build.yml?query=workflow:%22Node+CI%22)[![](https://img.shields.io/badge/Code_coverage-100%25-green) ](https://github.com/aws-lite/aws-lite/actions/workflows/build.yml?query=workflow:%22Node+CI%22)[![npm version](https://badge.fury.io/js/%40aws-lite%2Fclient.svg) ](https://badge.fury.io/js/%40aws-lite%2Fclient)[![Apache-2.0 License](https://img.shields.io/badge/License-Apache%202.0-blue.svg) ](https://opensource.org/licenses/Apache-2.0)[![](https://img.shields.io/discord/880272256100601927.svg?label=Join%20our%20Discord&logo=discord&logoColor=ffffff&color=5865F2&labelColor=grey)](https://discord.com/invite/y5A2eTsCRX)

-   [是谁做的?](https://npmcn.com/package/%40aws-lite/client/#readme-who-made-this)
-   [那么,这是什么 `aws-lite`? 吗?](https://npmcn.com/package/%40aws-lite/client/#readme-so-what-is-aws-lite)
-   [为什么不使用 `aws-sdk` 编号 : `@aws-sdk/*`? 吗?](https://npmcn.com/package/%40aws-lite/client/#readme-why-not-use-aws-sdk--aws-sdk)
-   [特征](https://npmcn.com/package/%40aws-lite/client/#readme-features)
-   [安装 `aws-lite`](https://npmcn.com/package/%40aws-lite/client/#readme-install-aws-lite)
-   [示例](https://npmcn.com/package/%40aws-lite/client/#readme-example)
-   [学多点](https://npmcn.com/package/%40aws-lite/client/#readme-learn-more)
    -   [客户端配置](https://npmcn.com/package/%40aws-lite/client/#readme-client-configuration)
    -   [要求/答复](https://npmcn.com/package/%40aws-lite/client/#readme-requests--responses)
    -   [使用类型脚本](https://npmcn.com/package/%40aws-lite/client/#readme-using-typescript)
    -   [插件 API](https://npmcn.com/package/%40aws-lite/client/#readme-plugin-api)
    -   [业绩](https://npmcn.com/package/%40aws-lite/client/#readme-performance)
    -   [捐款](https://npmcn.com/package/%40aws-lite/client/#readme-contributing)
-   [正式名单 `@aws-lite/*` 插件](https://npmcn.com/package/%40aws-lite/client/#readme-list-of-official-aws-lite-plugins)

* * *

## 是谁做的?

[`aws-lite`](https://aws-lite.org/) 由居民开发和维护 [OpenJS基金会建筑师](https://arc.codes/)我们小于3 AWS!

## 那么,这是什么 `aws-lite`? 吗?

[`aws-lite`](https://aws-lite.org/) 是一个简单,极快,可扩展的节点.js客户端,用于与AWS服务交互.

(其误报也好

你可以把它看作是AWS的JavaScript SDK的一种由社区驱动的替代品.

## 为什么不使用 `aws-sdk` 编号 : `@aws-sdk/*`? 吗?

亚马逊历史上在维持其SDK方面做了出色的工作. 然而,AWS已经将其被广泛采纳的v2 SDK贬值;其v3 SDK依赖于生成的代码,导致大量依赖,性能差,语义尴尬,难以理解文档,以及没有可使用堆栈痕迹的错误.

我们依靠并相信AWS,所以我们建立了 [`aws-lite`](https://aws-lite.org/) 在Node.js中提供更简单、更快、更稳定的位置,以便与AWS服务合作.

## 特征

-   [2-5x比AWS SDK v3快](https://aws-lite.org/performance)
-   简单的语义化和直接的基于承诺的界面
-   人可读文件
-   可自定义
-   堆栈跟踪和行号出错
-   内建平面
-   用 AWS 签名 v4 担保
-   不需要任何插件即可与任何 AWS 服务进行交互
-   自动解析/序列化 JSON, AWS- flavored JSON, 和 XML 请求/ 响应有效载荷
-   方便地与本地测试套件和AWS服务模拟
-   使用现有的服务插件,或 [开发自己的](https://aws-lite.org/api)
-   检查原始请求和回复的调试模式
-   就两个依附关系

## 安装 `aws-lite`

安装客户端 :

```shell
npm i @aws-lite/client
```

您可以使用客户端作为-is与 AWS 服务 APIs 快速交互,或者用这样的特定服务插件扩展:

```shell
npm i @aws-lite/dynamodb
```

一般情况下,类型可选 `@aws-lite/*-types` 软件包,可以这样添加:

```shell
npm i -D @aws-lite/dynamodb-types
```

[学习更多关于 `aws-lite` 类型.](https://aws-lite.org/configuration#types)

## 示例

现在开始给AWS打电话:

```javascript
// Instantiate a client with the DynamoDB plugin
import awsLite from '@aws-lite/client'
const aws = await awsLite({ region: 'us-west-1', plugins: [ import('@aws-lite/dynamodb') ] })

// Easily interact with the AWS services your application relies on
await aws.DynamoDB.PutItem({
  TableName: '$table-name',
  Item: {
    // AWS-lite automatically de/serializes DynamoDB JSON
    pk: '$item-key',
    data: {
      ok: true,
      hi: 'friends'
    }
  }
})

await aws.DynamoDB.GetItem({
  TableName: '$table-name',
  Key: { pk: '$item-key' }
})
// {
//   Item: {
//     pk: '$item-key',
//     data: data: {
//       ok: true,
//       hi: 'friends'
//     }
//   }
// }

// Use the lower-level client to fire a GET request by specifying a `service` and `endpoint`
await aws({
  service: 'lambda',
  endpoint: '/2015-03-31/functions/$function-name/configuration',
})
// {
//   FunctionName: '$function-name',
//   Runtime: 'nodejs20.x',
//   ...
// }

// POST JSON by adding a `payload` property
await aws({
  service: 'lambda',
  endpoint: '/2015-03-31/functions/$function-name/invocations',
  payload: { ok: true },
})
```

## 学多点

### [客户端配置](https://aws-lite.org/configuration)

证书和一般配置选项 [`aws-lite`](https://aws-lite.org/configuration)

### [要求/答复](https://aws-lite.org/request-response)

使用 [`aws-lite`](https://aws-lite.org/request-response) 提出请求并收到答复

### [使用类型脚本](https://aws-lite.org/using-typeScript)

使用 TypeScript 的指南和示例 `aws-lite`

### [插件 API](https://aws-lite.org/plugin-api)

文档和实例 `aws-lite` 插件 API

### [业绩](https://aws-lite.org/performance)

公开的、可复制的、现实世界的度量标准,用于 `aws-lite` 和其他 AWS SDKs 软件

### [捐款](https://aws-lite.org/contributing)

开源捐助方准则、方法和指示

## 正式名单 `@aws-lite/*` 插件

-   [ACM (英语)](https://www.npmjs.com/package/@aws-lite/acm)
-   [API 网关 V2](https://www.npmjs.com/package/@aws-lite/apigatewayv2)
-   [API 网关 WebSocket 管理 API](https://www.npmjs.com/package/@aws-lite/apigatewaymanagementapi)
-   [云阵](https://www.npmjs.com/package/@aws-lite/cloudformation)
-   [云纹](https://www.npmjs.com/package/@aws-lite/cloudfront)
-   [云表日志](https://www.npmjs.com/package/@aws-lite/cloudwatch-logs)
-   [迪纳摩DB](https://www.npmjs.com/package/@aws-lite/dynamodb)
-   [行政会议](https://www.npmjs.com/package/@aws-lite/iam)
-   [兰布达](https://www.npmjs.com/package/@aws-lite/lambda)
-   [组织](https://www.npmjs.com/package/@aws-lite/organizations)
-   [RDS 数据服务](https://www.npmjs.com/package/@aws-lite/rds-data)
-   [路线 53](https://www.npmjs.com/package/@aws-lite/route53)
-   [第3条](https://www.npmjs.com/package/@aws-lite/s3)
-   [用户](https://www.npmjs.com/package/@aws-lite/ses)
-   [简讯](https://www.npmjs.com/package/@aws-lite/sns)
-   [质量](https://www.npmjs.com/package/@aws-lite/sqs)
-   [特别事务](https://www.npmjs.com/package/@aws-lite/ssm)
-   [口译](https://www.npmjs.com/package/@aws-lite/sts)

## 常见问题

### @aws-lite/client 是什么？

简单、快、可扩展的 AWS 客户端

### 如何安装 @aws-lite/client？

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

### @aws-lite/client 支持 TypeScript 吗？

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

### @aws-lite/client 支持 ESM 还是 CommonJS？

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

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

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

### @aws-lite/client 可以商用吗？

@aws-lite/client 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws-lite/client 的下载量有多少？

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

### @aws-lite/client 还在维护吗？

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