# @cldmv/prettier-plugin-jsonv 中文文档

规范地址：https://npmcn.com/package/%40cldmv/prettier-plugin-jsonv/

版本：1\.2\.2
npm 元数据更新时间：2026-11-07T05:10:43.728Z
中文译文更新时间：2026-11-10T00:49:46.282Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cldmv/prettier-plugin-jsonv
原文对照：https://npmcn.com/package/%40cldmv/prettier-plugin-jsonv/?lang=original
项目主页：https://github.com/CLDMV/jsonv-prettier-plugin-jsonv#readme
源码仓库：https://github.com/CLDMV/jsonv-prettier-plugin-jsonv

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

- 包体积（解压后）：35.5 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- peer 依赖：prettier ^3\.0\.0，@cldmv/jsonv ^1\.1\.0
- 首次发布：2026-04-26T04:46:50.614Z
- 最新版本发布：2026-11-07T05:10:43.421Z
- 近 30 天下载量：4831（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

@ cldmv/ jsonv 文件的 Pretier 插件

## 安装

```sh
npm install @cldmv/prettier-plugin-jsonv
```

也可以使用：`pnpm add @cldmv/prettier-plugin-jsonv`、`yarn add @cldmv/prettier-plugin-jsonv`、`bun add @cldmv/prettier-plugin-jsonv`

## README

# @cldmv/ prettier-plugin-jsonv (英语)

[![npm version](https://img.shields.io/npm/v/%40cldmv%2Fprettier-plugin-jsonv.svg?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837)](https://www.npmjs.com/package/@cldmv/prettier-plugin-jsonv) [![npm downloads](https://img.shields.io/npm/dm/%40cldmv%2Fprettier-plugin-jsonv.svg?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837)](https://www.npmjs.com/package/@cldmv/prettier-plugin-jsonv) [![GitHub downloads](https://img.shields.io/github/downloads/CLDMV/jsonv-prettier-plugin-jsonv/total?style=for-the-badge&logo=github&logoColor=white&labelColor=181717)](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/releases) [![Last commit](https://img.shields.io/github/last-commit/CLDMV/jsonv-prettier-plugin-jsonv?style=for-the-badge&logo=github&logoColor=white&labelColor=181717)](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/commits) [![npm last update](https://img.shields.io/npm/last-update/%40cldmv%2Fprettier-plugin-jsonv?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837)](https://www.npmjs.com/package/@cldmv/prettier-plugin-jsonv)

[![Contributors](https://img.shields.io/github/contributors/CLDMV/jsonv-prettier-plugin-jsonv.svg?style=for-the-badge&logo=github&logoColor=white&labelColor=181717)](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/graphs/contributors) [![Sponsor shinrai](https://img.shields.io/github/sponsors/shinrai?style=for-the-badge&logo=githubsponsors&logoColor=white&labelColor=EA4AAA&label=Sponsor)](https://github.com/sponsors/shinrai)

用于格式化的 Pretier 插件 [杰森诺夫](https://github.com/CLDMV/jsonv) 文档.

## 曰如何是新来

### 最近:v1.2.2(2026年11月)

-   **工具发布, 无插件更改** 现在使用的 vitest 配置 `devCondition()` 从 `@cldmv/configs`,所以测试真的 逆 `src/` 通过 `prettier-plugin-jsonv-dev` 导出条件,并且类型脚本被拆分为 `types:check` 财务报告和审定财务报表 `types:build` (单位:千美元)[91号](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/pull/91), (中文(简体) ), [93号](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/pull/93)) (中文(简体) ). 格式不变.
-   [查看全文 v1.2.2 更改日志](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/master/docs/changelog/v1/v1.2.2.md)

### 最近发布的

-   **v1.2.1 (中文(简体) )** (2026年11月 - ) (中文(简体) ) `engines.node` 返回到 `>=18.0.0`;22.22.0开发层迁至 `devEngines` (单位:千美元)[88号](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/pull/88)(中文(简体) )[更改日志](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/master/docs/changelog/v1/v1.2.1.md)(中文(简体) )
-   **页:1** (2026年11月) — 通用JS条目,tsup building and a `prettier-plugin-jsonv-dev` 出口条件; `engines.node` 升为 `>=22.22.0`; 格式不变 (# 84, #85) ([更改日志](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/master/docs/changelog/v1/v1.2.0.md)(中文(简体) )
-   **页:1** (2026年10月) – 正在开发工具 `@cldmv/fix-headers` 2.2.0和2 `@cldmv/configs` 1.2.4; 没有补印文件, 没有运行时间变化(# 51, #54) ([更改日志](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/master/docs/changelog/v1/v1.1.4.md)(中文(简体) )
-   **页:1** (2026年10月) — 中央情报局 `✅ Required PR Check` 镜像任务运行在每条路径上,而不是跳过在repo PRs (# 49) ([更改日志](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/master/docs/changelog/v1/v1.1.3.md)(中文(简体) )

📚 **完整版本历史参见 [文件/更改日志/](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/tree/master/docs/changelog/) 编辑 [GitHub 发布](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/releases)。 。 。 .**

## 特征

-   格式 `.jsonv` 使用 @cldmv/jsonv 解析器的文件
-   支持所有ES2015-2025特性(JSON5, 二进制/八进制字元, BigInt, 数字分隔符等)
-   可配置的年份特征检测
-   正确处理评论意见和空白
-   与 Pretier 配置系统结合

## 安装

```bash
npm install --save-dev @cldmv/prettier-plugin-jsonv prettier @cldmv/jsonv
```

## 使用量

该插件需要Node.js 18.0.0或后期和Pretier 3. 它运载一个ES模块条目和一个普通JS条目,所以它从任一种类的Pretier配置中装入; `require()` 需要节点.js ^20.19.0或 ^22.13.0.

开发这个软件包需要节点22.22.0或以后(`devEngines`) (中文(简体) ).

### 使用 `.prettierrc.mjs` 或者说 `prettier.config.mjs`数字 :

```javascript
import jsonv from "@cldmv/prettier-plugin-jsonv";

export default {
    plugins: [jsonv],
    overrides: [
        {
            files: "*.jsonv",
            options: {
                jsonvYear: 2025,
                strictBigInt: false
            }
        }
    ]
};
```

### 使用 `.prettierrc.cjs` 或者说 `prettier.config.cjs`数字 :

```javascript
module.exports = {
    plugins: [require("@cldmv/prettier-plugin-jsonv")],
    overrides: [
        {
            files: "*.jsonv",
            options: {
                jsonvYear: 2025,
                strictBigInt: false
            }
        }
    ]
};
```

`require("@cldmv/prettier-plugin-jsonv")` 返回插件对象本身。 在一个JSON `.prettierrc`,将插件按名称列出: `"plugins": ["@cldmv/prettier-plugin-jsonv"]`。 。 。 .

## 配置选项

| 选项 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `jsonvYear` | 编号 | 2025 (英语) | JSONV 特性使用年份( 2015-2025) |
| `strictBigInt` | 布尔 | 虚假 | 是否执行严格的 BigInt 解析 |

### 跟踪逗号

插件符合 Pretier 的 [`trailingComma`](https://prettier.io/docs/options#trailing-commas) 选项:

-   `"all"` (prettier的默认)和 `"es5"` 在每个跨行对象或阵列的最后一个条目后加一个逗号。 非空对象和数组总是每行打印一个条目,所以只有空条目(`{ }`, (中文(简体) ), `[]`)被打印在一行上,他们永远得不到逗号.
-   `"none"` 从来没有增加一个.

在源代码中已经存在拖放的逗号不保存为已写入: 选项使其正常化, 在最后一个条目后添加或去除逗号 。 每个jsonv 年(2011–2025年)允许后缀逗号,因此逗号永远不会使文档无效,也不会改变解析值. 在最后一个条目旁边保留的评论 : `a: 1, // note` 在逗号后保留注释, `a: 1 /* note */,` 留着它之前.

## 发展

已发布的软件包只包含已建 `dist/` (单位:千美元)`dist/index.mjs`,以及 `dist/index.cjs` 页:1 `require()`\+ 生成 `types/`在一次离职中 `prettier-plugin-jsonv-dev` 导出条件将包指向 `src/` 相反:

| 运行 | 装入 |
| --- | --- |
| `node app.mjs` | `dist/index.mjs` (运行) `npm run build` (第一个) |
| `node --conditions=prettier-plugin-jsonv-dev app.mjs` | `src/index.mjs` |
| `require()` 与 `--conditions=prettier-plugin-jsonv-dev` | `src/index.cjs`,负载 `src/index.mjs` |

每个外壳设定一次 `export NODE_OPTIONS=--conditions=prettier-plugin-jsonv-dev`。 。 。 . `npm test` 运行 Vitest 套件与 `src/` 条件,然后构建和检查通用JS条目 `dist/` 与 `node --test`。 。 。 .

## 许可证

[![GitHub license](https://img.shields.io/github/license/CLDMV/jsonv-prettier-plugin-jsonv.svg?style=for-the-badge&logo=github&logoColor=white&labelColor=181717)](https://github.com/CLDMV/jsonv-prettier-plugin-jsonv/blob/HEAD/LICENSE) [![npm license](https://img.shields.io/npm/l/%40cldmv%2Fprettier-plugin-jsonv.svg?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837)](https://www.npmjs.com/package/@cldmv/prettier-plugin-jsonv)

阿帕奇-2.0 ©新来/ CLDMV

## 常见问题

### @cldmv/prettier-plugin-jsonv 是什么？

@ cldmv/ jsonv 文件的 Pretier 插件

### 如何安装 @cldmv/prettier-plugin-jsonv？

在项目目录运行 npm install @cldmv/prettier-plugin-jsonv，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：prettier（^3\.0\.0）、@cldmv/jsonv（^1\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cldmv/prettier-plugin-jsonv 支持 TypeScript 吗？

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

### @cldmv/prettier-plugin-jsonv 支持 ESM 还是 CommonJS？

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

### @cldmv/prettier-plugin-jsonv 需要什么版本的 Node\.js？

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

### @cldmv/prettier-plugin-jsonv 可以商用吗？

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

### @cldmv/prettier-plugin-jsonv 的下载量有多少？

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

### @cldmv/prettier-plugin-jsonv 还在维护吗？

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