# @dstoolkit/data-structures 中文文档

规范地址：https://npmcn.com/package/%40dstoolkit/data-structures/

版本：1\.6\.0
npm 元数据更新时间：2026-10-04T22:12:28.888Z
中文译文更新时间：2026-11-12T23:56:12.419Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：389 kB，73 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- 首次发布：2026-09-15T13:36:50.827Z
- 最新版本发布：2026-10-04T22:12:28.575Z
- 近 30 天下载量：2802（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

综合收集了TypeScript/JavaScript的通用数据结构实施,发布于npm.

## 安装

```sh
npm install @dstoolkit/data-structures
```

也可以使用：`pnpm add @dstoolkit/data-structures`、`yarn add @dstoolkit/data-structures`、`bun add @dstoolkit/data-structures`

## README

# 数据结构

为TypeScript/JavaScript综合收集了类型安全,零依赖性的数据结构执行.

[![JSR](https://jsr.io/badges/@dstoolkit/data-structures)](https://jsr.io/@dstoolkit/data-structures) [![JSR Score](https://jsr.io/badges/@dstoolkit/data-structures/score)](https://jsr.io/@dstoolkit/data-structures) [![npm version](https://badge.fury.io/js/@dstoolkit%2Fdata-structures.svg)](https://www.npmjs.com/package/@dstoolkit/data-structures) [![codecov](https://codecov.io/gh/mandy8055/data-structures/branch/main/graph/badge.svg)](https://codecov.io/gh/mandy8055/data-structures) [![CI](https://github.com/mandy8055/data-structures/actions/workflows/release-please.yml/badge.svg)](https://github.com/mandy8055/data-structures/actions/workflows/release-please.yml)

## 📚 [完整文档](https://data-structures-docs.vercel.app/)

访问我们的综合文献网站,了解详细的指南、API参考文献和实例.

## 快速启动

### 安装

**无 :**

```bash
npm install @dstoolkit/data-structures
```

**德诺(JSR):**

```typescript
import { Queue, LRUCache } from 'jsr:@dstoolkit/data-structures';
```

### 示例

```typescript
import { Queue, LRUCache } from '@dstoolkit/data-structures';

// FIFO Queue
const queue = new Queue<number>();
queue.enqueue(1);
queue.enqueue(2);
console.log(queue.dequeue()); // 1

// LRU Cache
const cache = new LRUCache<string, number>({ capacity: 100 });
cache.put('key', 42);
console.log(cache.get('key')); // 42
```

## 数据结构

-   **队列**: 队列, 德克, 优先级
-   **名单**: 链接列表, DoublyLinked 列表
-   **堆积**: 二进制平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平
-   **树**: 树; 三重; 红黑三重奏
-   **地图笼罩( C)**: 排序地图、 双线地图、 LRUCache

## 特征

-   🎯 **类型安全** - 有通用软件的完整脚本支持
-   📦 **无依赖** - 轻而易举和安全
-   ⚡ **业绩** - 以记录的时间复杂性优化执行工作
-   🧪 **测试良好** - 综合测试覆盖率(~100%)
-   🌲 **可摇动的树** - 只导入你需要的东西
-   🔄 **双重出版** - 在JSR和npm上都有

## 链接

-   📚 **[文档](https://data-structures-docs.vercel.app/)** - 完整指南和API参考
-   🐛 **[问题](https://github.com/mandy8055/data-structures/issues)** - 报告错误或请求特性
-   💬 **[讨论情况](https://github.com/mandy8055/data-structures/discussions)** - 有想法吗? 我们讨论一下

## 许可证

麻省理工学院许可证 - 可以在自己的项目中使用这个!

## 常见问题

### @dstoolkit/data-structures 是什么？

综合收集了TypeScript/JavaScript的通用数据结构实施,发布于npm\.

### 如何安装 @dstoolkit/data-structures？

在项目目录运行 npm install @dstoolkit/data-structures，或使用 pnpm add / yarn add / bun add。

### @dstoolkit/data-structures 支持 TypeScript 吗？

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

### @dstoolkit/data-structures 支持 ESM 还是 CommonJS？

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

### @dstoolkit/data-structures 需要什么版本的 Node\.js？

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

### @dstoolkit/data-structures 可以商用吗？

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

### @dstoolkit/data-structures 的下载量有多少？

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

### @dstoolkit/data-structures 还在维护吗？

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