# @morphql/store 中文文档

规范地址：https://npmcn.com/package/%40morphql/store/

版本：0\.1\.47
npm 元数据更新时间：2026-11-01T19:47:34.997Z
中文译文更新时间：2026-11-01T22:50:03.629Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40morphql/store
原文对照：https://npmcn.com/package/%40morphql/store/?lang=original
项目主页：https://github.com/Hyperwindmill/morphql/tree/main/packages/store#readme
源码仓库：https://github.com/Hyperwindmill/morphql

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

- 包体积（解压后）：44.4 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-05-18T19:40:29.028Z
- 最新版本发布：2026-11-01T19:47:34.683Z
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

morphql的内存和持久数据存储，具有类似sql的查询支持。

## 安装

```sh
npm install @morphql/store
```

也可以使用：`pnpm add @morphql/store`、`yarn add @morphql/store`、`bun add @morphql/store`

## README

![MorphQL](https://raw.githubusercontent.com/Hyperwindmill/morphql/main/morphql.png)

[![npm version](https://img.shields.io/npm/v/@morphql/store?label=%40morphql%2Fstore)](https://www.npmjs.com/package/@morphql/store) ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)

# @morphql /存储

的轻量级数据存储 **MorphQL** 使用熟悉的类似sql的查询接口。 `SELECT`， `INSERT`， `UPDATE`, `DELETE` 语句被翻译成MorphQL，并在可插拔的存储适配器上执行。

## 关键特性

-   🗂️ **sql API**：查询和修改数据 `SELECT`， `INSERT`， `UPDATE`， `DELETE`.
-   🔌 **可插入适配器**：用于测试和运行时数据的内存适配器，用于json磁盘持久性的文件夹适配器。
-   🚀 **由MorphQL支持**语句被翻译为MorphQL并编译为本机JS以快速执行。
-   🔢 **自动增量**:内置 `auto()` / `$auto` 数字主键的占位符。
-   🌐 **同构的核心**内存适配器在Node.js和浏览器中同时运行；文件夹适配器是Node-only。

## 安装

```bash
npm install @morphql/store
```

## 使用

### 内存中的存储

```typescript
import { Store, MemoryAdapter } from '@morphql/store';

const store = new Store(new MemoryAdapter());

await store.query(`INSERT INTO users (id, name, age) VALUES (auto(), 'Alice', 30)`);
await store.query(`INSERT INTO users (id, name, age) VALUES (auto(), 'Bob', 17)`);

const adults = await store.query(`SELECT name FROM users WHERE age >= 18`);
// → [{ name: 'Alice' }]
```

### 持久文件夹存储（Node.js）

```typescript
import { Store } from '@morphql/store';
import { FolderAdapter } from '@morphql/store/node';

const store = new Store(new FolderAdapter('./data', { pretty: true }));

await store.query(`UPDATE users SET status = 'active' WHERE age >= 18`);
```

每个表都以JSON文件的形式保存在目录中(例如： `./data/users.json`）。

## 了解更多

-   👉 **[官方文档](https://hyperwindmill.github.io/morphql/)**
-   🏠 **[主要存储库](https://github.com/Hyperwindmill/morphql)**

## 许可证

麻省理工学院

## 常见问题

### @morphql/store 是什么？

morphql的内存和持久数据存储，具有类似sql的查询支持。

### 如何安装 @morphql/store？

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

### @morphql/store 支持 TypeScript 吗？

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

### @morphql/store 支持 ESM 还是 CommonJS？

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

### @morphql/store 可以商用吗？

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

### @morphql/store 还在维护吗？

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