mumuy/relationship

这是什么？

核心功能

• 01根据关系路径计算称呼，如“妈妈的妈妈的哥哥”。
• 02支持反向查询，显示对方应如何称呼自己。
• 03可返回关系链，以及两人之间的关系。
• 04识别同一亲属的多种地方叫法。
• 05通过 setMode 自定义地区称谓模式。
• 06既可在浏览器中引入，也可通过 npm 在 Node.js 中使用。

适用场景

• 春节等家庭聚会前，查清楚该如何称呼较疏远的亲戚。
• 开发需要中文称谓的家谱或亲属关系应用。
• 在网站或工具中加入中文亲属称谓查询功能。
• 研究中文亲属称谓与家庭关系之间的对应规则。

快速上手

1. 1

   从 npm 安装该包

   npm install relationship.js
2. 2

   在 Node.js 中用 CommonJS 方式引入模块

   const relationship = require("relationship.js");
3. 3

   查询应该如何称呼某位亲戚

   relationship({text:'妈妈的妈妈的哥哥'});

使用前须知

• !称谓因南北方和地区而异，结果可能与你所在地的习惯不一致。
• !部分称呼有多种关系且跨辈分，结果可能存在歧义。

标签

常见问题

relationship 是什么？

中国亲戚称谓计算器，可查询称呼或亲属关系，提供 JavaScript 库。 Relationship 是一个用于计算中国亲属称谓的 JavaScript 库，输入一个亲属关系（如“妈妈的妈妈的哥哥”），即可返回对应的称呼；反向模式则可以告诉你对方应如何称呼自己。它还能给出称谓背后的关系链，或计算两个人之间的关系。

relationship 可以免费使用吗？用的什么许可证？

relationship 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

relationship 还在维护吗？

活跃维护中。relationship 最近一次提交是在 2026年10月18日。

relationship 适合用来做什么？

春节等家庭聚会前，查清楚该如何称呼较疏远的亲戚。 开发需要中文称谓的家谱或亲属关系应用。 在网站或工具中加入中文亲属称谓查询功能。 研究中文亲属称谓与家庭关系之间的对应规则。

relationship 怎么安装和运行？

从 npm 安装该包: npm install relationship.js 在 Node.js 中用 CommonJS 方式引入模块: const relationship = require("relationship.js"); 查询应该如何称呼某位亲戚: relationship({text:'妈妈的妈妈的哥哥'});

在哪里获取 relationship？

源代码和安装说明在 GitHub 上：https://github.com/mumuy/relationship