# @casual-simulation/fast-json-stable-stringify 中文文档

规范地址：https://npmcn.com/package/%40casual-simulation/fast-json-stable-stringify/

版本：4\.0\.5
npm 元数据更新时间：2026-01-30T22:05:26.699Z
中文译文更新时间：2026-11-09T09:28:22.479Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40casual-simulation/fast-json-stable-stringify
原文对照：https://npmcn.com/package/%40casual-simulation/fast-json-stable-stringify/?lang=original
项目主页：https://github.com/casual-simulation/casualos/tree/develop/src/fast-json-stable-stringify
源码仓库：https://github.com/casual-simulation/casualos

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

- 包体积（解压后）：234 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=8
- 运行依赖：0 个
- 首次发布：2021-10-11T18:08:05.337Z
- 最新版本发布：2026-01-30T22:05:26.400Z
- 近 30 天下载量：3101（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 7 个）

## 中文简介

决定性 `JSON.stringify()` - 一个更快的版本 底板的json-stable-strigfy 不jsonify

## 安装

```sh
npm install @casual-simulation/fast-json-stable-stringify
```

也可以使用：`pnpm add @casual-simulation/fast-json-stable-stringify`、`yarn add @casual-simulation/fast-json-stable-stringify`、`bun add @casual-simulation/fast-json-stable-stringify`

## README

# 快速- json- 稳定- 字符串

> 从 [https://github.com/epoberezkin/fast-json-stable-stringify 页面存档备份,存于互联网档案馆](https://github.com/epoberezkin/fast-json-stable-stringify)。 。 。 . 变化包括转换为TypeScript并增加缩进JSON输出的能力.

决定性 `JSON.stringify()` - 一个更快的版本 [@ substack (中文(简体) )](https://github.com/substack)'json-稳住-稳住没有 [齐声](https://github.com/substack/jsonify)。 。 。 .

您也可以通过自定义比较函数.

# 实例

```js
var stringify = require('fast-json-stable-stringify');
var obj = { c: 8, b: [{ z: 6, y: 5, x: 4 }, 7], a: 3 };
console.log(stringify(obj));
```

输出 :

```
{"a":3,"b":[{"x":4,"y":5,"z":6},7],"c":8}
```

# 方法

```js
var stringify = require('fast-json-stable-stringify');
```

## var str = 字符串(obj, 选项)

返回决定性的字符串 `str` 从对象 `obj`。 。 。 .

## 选项

### cmp 数据

若为 `opts` ,您可以提供 `opts.cmp` 要进行自定义比较 函数用于对象键。 你的职责 `opts.cmp` 与这些 参数 :

```js
opts.cmp({ key: akey, value: avalue }, { key: bkey, value: bvalue });
```

例如,要对对象的密钥名称进行排序,按您可以写的倒序排序 :

```js
var stringify = require('fast-json-stable-stringify');

var obj = { c: 8, b: [{ z: 6, y: 5, x: 4 }, 7], a: 3 };
var s = stringify(obj, function (a, b) {
    return a.key < b.key ? 1 : -1;
});
console.log(s);
```

输出字符串中的结果 :

```
{"c":8,"b":[{"z":6,"y":5,"x":4},7],"a":3}
```

或者如果你想按反向顺序排序对象值,你可以写:

```
var stringify = require('fast-json-stable-stringify');

var obj = { d: 6, c: 5, b: [{z:3,y:2,x:1},9], a: 10 };
var s = stringify(obj, function (a, b) {
    return a.value < b.value ? 1 : -1;
});
console.log(s);
```

哪些产出:

```
{"d":6,"c":5,"b":[{"z":3,"y":2,"x":1},9],"a":10}
```

### 周期

过 `true` 内 `opts.cycles` 将循环属性字符串为 `__cycle__` - 结果不会是 JSON 有效的字符串.

如果没有这个选项, TypeError 将会被扔到循环对象中 .

# 安装

与 [无](https://npmjs.org/) ưμ㼯a

```
npm install fast-json-stable-stringify
```

# 基准

要运行基准( 需要节点 6 + ):

```
node benchmark
```

结果:

```
fast-json-stable-stringify x 17,189 ops/sec ±1.43% (83 runs sampled)
json-stable-stringify x 13,634 ops/sec ±1.39% (85 runs sampled)
fast-stable-stringify x 20,212 ops/sec ±1.20% (84 runs sampled)
faster-stable-stringify x 15,549 ops/sec ±1.12% (84 runs sampled)
The fastest is fast-stable-stringify
```

## 企业支助

快速- json- 稳定- 字符串包是 [Tidelift 企业订阅](https://tidelift.com/subscription/pkg/npm-fast-json-stable-stringify?utm_source=npm-fast-json-stable-stringify&utm_medium=referral&utm_campaign=enterprise&utm_term=repo) - 除了软件维护者提供的支助外,它还为开源软件用户提供集中的商业支助.

## 安全联络

请使用 [电梯安全联络](https://tidelift.com/security)。 。 。 . Tidelift将协调固定和披露。 请不要通过 GitHub 问题报告安全弱点 .

# 许可证

[麻省理工学院](https://github.com/epoberezkin/fast-json-stable-stringify/blob/master/LICENSE)

## 常见问题

### @casual-simulation/fast-json-stable-stringify 是什么？

决定性 JSON\.stringify\(\) - 一个更快的版本 底板的json-stable-strigfy 不jsonify

### 如何安装 @casual-simulation/fast-json-stable-stringify？

在项目目录运行 npm install @casual-simulation/fast-json-stable-stringify，或使用 pnpm add / yarn add / bun add。

### @casual-simulation/fast-json-stable-stringify 支持 TypeScript 吗？

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

### @casual-simulation/fast-json-stable-stringify 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @casual-simulation/fast-json-stable-stringify 需要什么版本的 Node\.js？

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

### @casual-simulation/fast-json-stable-stringify 可以商用吗？

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

### @casual-simulation/fast-json-stable-stringify 的下载量有多少？

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

### @casual-simulation/fast-json-stable-stringify 还在维护吗？

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