# @conformetry/languages 中文文档

规范地址：https://npmcn.com/package/%40conformetry/languages/

版本：0\.0\.77
npm 元数据更新时间：2026-11-10T14:25:34.699Z
中文译文更新时间：2026-11-10T15:24:38.393Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40conformetry/languages
原文对照：https://npmcn.com/package/%40conformetry/languages/?lang=original
项目主页：https://github.com/organizzolini/codebase/tree/main/projects/ic-suite/conformetry/conformetry-languages#readme
源码仓库：https://github.com/organizzolini/codebase

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

- 包体积（解压后）：99.1 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2026-10-04T22:26:28.327Z
- 最新版本发布：2026-11-10T14:25:34.305Z
- 近 30 天下载量：11013（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 75 个）

## 中文简介

多语种文件比较和语法验证符

## 安装

```sh
npm install @conformetry/languages
```

也可以使用：`pnpm add @conformetry/languages`、`yarn add @conformetry/languages`、`bun add @conformetry/languages`

## README

# \* 调和语言

[![npm](https://img.shields.io/npm/v/@conformetry/languages?logo=npm&label=npm)](https://www.npmjs.com/package/@conformetry/languages)

每种语言 [调和](https://npmcn.com/package/%40conformetry/conformetry-cli/README.md) 将文件与, 一个进口的背后——加上决定其中哪些需要运行的决议.

```bash
npm install --save-dev @conformetry/languages
```

## 语言

A 类 **语言** 是用于一个文件类型家族的比较引擎。 每一个都是 模块,显示一个 NestJS 模块和一个服务,每个模块宣布 申请延期.

| 模块 | 索偿 | 比较一下 |
| --- | --- | --- |
| `json` | `.json`, (中文(简体) ), `.jsonc` | 由 JSON 路径而不是行号处理的模板声明的每个密钥和值 |
| `jupyter` | `.ipynb` | 笔记本的信封、标记下单元格和密码单元格,通过授权给 `json`, (中文(简体) ), `markdown`,以及 `python` |
| `markdown` | `.md` | 文档的语法树——标题,列表,链接——而不是所提供文本 |
| `python` | `.py` | Python 自己的抽象语法树, 通过运入的解译器 `src/python/` |
| `text` | `.txt` | 每个模板行, 重复意识和命令独立 |
| `typescript` | `.ts`, (中文(简体) ), `.tsx` | 通过 TypeScript 编译器声明、签名和注释 |

每一个都是下限,而不是确切的规格: 实例可以添加其模板未提及的内容.

## 解析和后退

`LanguagesService` 使用扩展名 运行的模板声明并返回 所以JSON的寄存器从来不报告 TypeScript 结果它没什么好说的.

扩展名 **没有** 语言要求没有跳过。 它被传送到 **倒计时** - 文字语言,也拓宽以要求这些扩展 按行比较。 这就是阻止 `.toml` 或一个 `.cfg` 在模板中 语言是每一层下的一个楼 运行而不是在六个选择之一.

注册语言是单步:添加到 `claimingLanguages` 内 `LanguagesService`它自己的描述者说它要求的扩展,所以 没有第二份名单可以保持同步.

## 平顶桥

`python/` 持有一个小型 Python 包,以及 `PythonBridgeService` 产卵 `python3` 因为Python的语法树只能从 彼菩萨. 路径由服务处自己的模块位置解决,而不是 从工作目录中找到,所以桥是否 符合从退出或从 `node_modules`。 。 。 .

解释器是在一种方法中产出, 从来没有在模块范围, 所以导入 机器上的这个软件包没有 `python3` 这是无害的。 缺少翻译 表面作为报告的 `.py` 文件——可见,而不是 被误认为符合.

## 出口

`LanguagesModule` 财务报告和审定财务报表 `LanguagesService`,每个语言的模块和服务, 和辅助者服务 语言从 - `JsonComparisonService`, (中文(简体) ), `JupyterNotebookService`, (中文(简体) ), `MarkdownNodesService`, (中文(简体) ), `MarkdownTreeService`, (中文(简体) ), `PythonBridgeService`, (中文(简体) ), `TypescriptCommentsService`, (中文(简体) ), `TypescriptNodesService`,以及 `TypescriptTreeService`。 。 。 .

一个主机几乎总是想要 `LanguagesModule`,用于进口和再出口 六点.

## 为什么一个包裹

这6种语言是6种语言,直到合并记录 [ADR 0006 (韩语)](https://npmcn.com/documentation/adr/0006-hold-every-conformetry-language-in-one-package.md)。 。 。 . 这个记录是用来读读安装这个软件包的成本 他们只需要一种语言, 为什么支付它赢了, 以及哪三种选择 被重压和拒绝.

## 测试

```bash
nx run conformetry-languages:vitest
```

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/LICENSE)。 。 。 .

## \* 调和

这个项目源于 [巢-服务-项目](https://npmcn.com/configuration/conformetry-templates/nestjs-service-project) 符合模板.

## 常见问题

### @conformetry/languages 是什么？

多语种文件比较和语法验证符

### 如何安装 @conformetry/languages？

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

### @conformetry/languages 支持 TypeScript 吗？

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

### @conformetry/languages 支持 ESM 还是 CommonJS？

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

### @conformetry/languages 可以商用吗？

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

### @conformetry/languages 的下载量有多少？

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

### @conformetry/languages 还在维护吗？

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