让开源，少一点语言距离。
npm包中文文档

@cospired/i18n-iso-languages

中文文档
4.2.0发布于 2024/01/28MITTypeScriptCommonJS零依赖近 30 天下载 19.2万

iSO 639 语言代码的i18n

中文使用文档
中文原文
文档目录13 节
  1. 安装
  2. 语言代码
  3. 以 ISO 639-1 (Alpha-2) 、 ISO 639-2/ T 或 B (Alpha-3) 代码获取语言名称
  4. 按 ISO 639-1 代码获取所有名称
  5. 支助语言(ISO 639-1)
  6. 语言到代码
  7. 代码
  8. 将 ISO 639-2 (Alpha-3) 转换为 ISO 639-1 (Alpha-2) 代码
  9. 将 ISO 639-1 (Alpha-2) 转换为 ISO 639-2 (Alpha-3) 代码
  10. 获取全部 ISO 639-1( Alpha-2) 代码
  11. 获取全部 ISO 639-2 (Alpha-3) 代码
  12. 验证语言代码
  13. 捐款

Build Status npm version Maintainability Test Coverage

i18n-同位素语言

i18n用于ISO 639语言代码. 我们支持阿尔法-2,阿尔法-3 B和T代码来自 https://en.wikipedia.org/wiki/List of ISO 639-1 codes 页面存档备份,存于互联网档案馆

这个软件包主要基于 i18n-同位素国家。 。 。 .

我们打算让i18n-iso-语言的界面尽可能接近i18n-iso-country.

安装

使用 npm 安装 : npm install @cospired/i18n-iso-languages

如果在浏览器环境中使用, 您需要手动安装您想要支持的本地端 .

var languages = require("@cospired/i18n-iso-languages");

// Support german & english languages.
languages.registerLocale(require("@cospired/i18n-iso-languages/langs/en.json"));
languages.registerLocale(require("@cospired/i18n-iso-languages/langs/de.json"));

语言代码

以 ISO 639-1 (Alpha-2) 、 ISO 639-2/ T 或 B (Alpha-3) 代码获取语言名称

var languages = require("@cospired/i18n-iso-languages");
console.log("de (639-1/Alpha-2) => " + languages.getName("de", "en")); // German
console.log("en (639-1/Alpha-2) => " + languages.getName("de", "de")); // Deutsch
console.log("de (639-2T/Alpha-3) => " + languages.getName("deu", "en")); // German
console.log("de (639-2B/Alpha-3) => " + languages.getName("ger", "en")); // German

按 ISO 639-1 代码获取所有名称

var languages = require("@cospired/i18n-iso-languages");
console.log(languages.getNames("en")); // { 'ab': 'Abkhazian', 'aa': 'Afar', [...], 'za': 'Zhuang', 'zu': 'Zulu' }

支助语言(ISO 639-1)

ISO 639-1 代码列表

语言到代码

var languages = require("@cospired/i18n-iso-languages");
console.log("German => " + languages.getAlpha2Code('German', 'en'));
// German => de

console.log("German => " + languages.getAlpha3TCode('German', 'en'));
// German => deu

console.log("German => " + languages.getAlpha3BCode('German', 'en'));
// German => ger

代码

将 ISO 639-2 (Alpha-3) 转换为 ISO 639-1 (Alpha-2) 代码

var languages = require("@cospired/i18n-iso-languages");
console.log("deu (Alpha-3) => " + languages.alpha3ToAlpha2("deu") + " (Alpha-2)");
// deu (Alpha-3 T) => de (Alpha-2)

var languages = require("@cospired/i18n-iso-languages");
console.log("ger (Alpha-3 B) => " + languages.alpha3ToAlpha2("ger") + " (Alpha-2)");
// ger (Alpha-3 B) => de (Alpha-2)

将 ISO 639-1 (Alpha-2) 转换为 ISO 639-2 (Alpha-3) 代码

var languages = require("@cospired/i18n-iso-languages");
console.log("de (Alpha-2) => " + languages.alpha2ToAlpha3T("de") + " (Alpha-3 T)");
// de (Alpha-2) => deu (Alpha-3 T)

var languages = require("@cospired/i18n-iso-languages");
console.log("de (Alpha-2) => " + languages.alpha2ToAlpha3B("de") + " (Alpha-3 B)");
// de (Alpha-2) => ger (Alpha-3 B)

获取全部 ISO 639-1( Alpha-2) 代码

var languages = require("@cospired/i18n-iso-languages");
console.log(languages.getAlpha2Codes());
// { 'aa': 'aar', 'ab': 'abk', [...], 'za': 'zha', 'zu': 'zul' }

获取全部 ISO 639-2 (Alpha-3) 代码

var languages = require("@cospired/i18n-iso-languages");
console.log(languages.getAlpha3TCodes());
// { 'aar': 'aa', 'abk': 'ab', [...], 'zha': 'za', 'zul': 'zu' }

var languages = require("@cospired/i18n-iso-languages");
console.log(languages.getAlpha3BCodes());
// { 'aar': 'aa', 'abk': 'ab', [...], 'zha': 'za', 'zul': 'zu' }

验证语言代码

var languages = require("@cospired/i18n-iso-languages");
console.log(languages.isValid("de"), languages.isValid("ger"), languages.isValid("xx")));
// true, true, false

捐款

要添加语言:

  • 在lags/(按字母顺序)下添加一个 json 文件
  • 将语言添加到 data 位于顶端的enty-node.js对象(以字母顺序排列)
  • 在区域中添加语言 支持的语言 以 README.md (按字母顺序排列)
  • 在 package.json (以字母顺序排列) 中将语言添加到关键字中
  • 将语言添加到更改日志的“ 未释放” 部分
  • 运行 npm install && make test 确保考试通过
  • 在 GitHub 上打开 PR

请不要更改 package.json, package-lock.json 或 changelog.md中的版本.

版本与发布记录

@cospired/i18n-iso-languages 共发布 25 个版本，首次发布于 2018/02/21；过去 12 个月发布了 0 个版本。

版本发布日期距今
4.2.0latest2024/01/282 年前
4.1.02023/03/103 年前
4.0.12023/01/223 年前
4.0.02022/03/204 年前
3.2.12022/03/184 年前
3.2.02022/03/184 年前

关于 @cospired/i18n-iso-languages 的常见问题

@cospired/i18n-iso-languages 是什么？

iSO 639 语言代码的i18n

如何安装 @cospired/i18n-iso-languages？

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

@cospired/i18n-iso-languages 支持 TypeScript 吗？

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

@cospired/i18n-iso-languages 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。

@cospired/i18n-iso-languages 需要什么版本的 Node.js？

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

@cospired/i18n-iso-languages 可以商用吗？

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

@cospired/i18n-iso-languages 的下载量有多少？

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

@cospired/i18n-iso-languages 还在维护吗？

最新版本 4.2.0 发布于 2024/01/28（2 年前）；至今共发布 25 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/02/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。