# @cospired/i18n-iso-languages 中文文档 规范地址：https://npmcn.com/package/%40cospired/i18n-iso-languages/ 版本：4\.2\.0 npm 元数据更新时间：2024-01-28T13:24:38.996Z 中文译文更新时间：2026-11-10T20:27:01.836Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cospired/i18n-iso-languages 原文对照：https://npmcn.com/package/%40cospired/i18n-iso-languages/?lang=original 项目主页：https://github.com/cospired/i18n-iso-languages#readme 源码仓库：https://github.com/cospired/i18n-iso-languages ## 关键信息（来自 npm 元数据） - 包体积（解压后）：229 kB，52 个文件 - 模块格式：CommonJS - TypeScript 类型：包内自带 - Node.js 要求：^12\.22\.0 \|\| ^14\.17\.0 \|\| \>=16\.0\.0 - 运行依赖：0 个 - 首次发布：2018-02-21T13:25:37.931Z - 最新版本发布：2024-01-28T13:24:38.796Z - 近 30 天下载量：192144（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：25（近 12 个月 0 个） ## 中文简介 iSO 639 语言代码的i18n ## 安装 ```sh npm install @cospired/i18n-iso-languages ``` 也可以使用：`pnpm add @cospired/i18n-iso-languages`、`yarn add @cospired/i18n-iso-languages`、`bun add @cospired/i18n-iso-languages` ## README [![Build Status](https://travis-ci.com/cospired/i18n-iso-languages.svg?branch=main)](https://travis-ci.com/cospired/i18n-iso-languages) [![npm version](https://badge.fury.io/js/%40cospired%2Fi18n-iso-languages.svg)](https://badge.fury.io/js/%40cospired%2Fi18n-iso-languages) [![Maintainability](https://api.codeclimate.com/v1/badges/31071476c2117e90d6fe/maintainability)](https://codeclimate.com/github/cospired/i18n-iso-languages/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/31071476c2117e90d6fe/test_coverage)](https://codeclimate.com/github/cospired/i18n-iso-languages/test_coverage) # i18n-同位素语言 i18n用于ISO 639语言代码. 我们支持阿尔法-2,阿尔法-3 B和T代码来自 [https://en.wikipedia.org/wiki/List of ISO 639-1 codes 页面存档备份,存于互联网档案馆](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) 这个软件包主要基于 [i18n-同位素国家](https://github.com/michaelwittig/node-i18n-iso-countries)。 。 。 . 我们打算让i18n-iso-语言的界面尽可能接近i18n-iso-country. ## 安装 使用 npm 安装 : `npm install @cospired/i18n-iso-languages` 如果在浏览器环境中使用, 您需要手动安装您想要支持的本地端 . ```javascript 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) 代码获取语言名称 ```javascript 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 代码获取所有名称 ```javascript var languages = require("@cospired/i18n-iso-languages"); console.log(languages.getNames("en")); // { 'ab': 'Abkhazian', 'aa': 'Afar', [...], 'za': 'Zhuang', 'zu': 'Zulu' } ``` ### 支助语言(ISO 639-1) - `ar`阿拉伯文(基于 [https://github.com/umpirsky/language-list/blob/master/data/ar/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/ar/language.json)(中文(简体) ) - `bg`: 保加利亚语(基于https://bg.wikipedia.org/wiki/Кодове на езици),略有调整 - `br`: Breton (基于https://br.wikipedia.org/wiki/leepn glok kodo ISO 639-1) - `cs`: 捷克语(基于https://cs.wikipedia.org/wiki/Seznam kódů -ISO 639-1) - `da`: 丹麦语( 基于 [https://da.wikipedia.org/wiki/ISO 639-1 请检查isbn=值 (帮助)](https://da.wikipedia.org/wiki/ISO_639-1)(中文(简体) ) - `de`: 德文(由当地人讲) - `en`:英语(ISO 639-1标准名) - `es`: 西班牙语(基于 [https://es.wikipedia.org/wiki/ISO 639-1 (英语)](https://es.wikipedia.org/wiki/ISO_639-1)(中文(简体) ) - `fi`:芬兰语(基于 [https://kotoistus.fi/suositukset/suositukset-kilet-fi-koodi/ 互联网档案馆的存檔,存档日期2014-12-22](https://kotoistus.fi/suositukset/suositukset-kielet-fi-koodi/)(中文(简体) ) - `fr`: 法语(基于 [https://fr.wikipedia.org/wiki/Liste des codes ISO 639-1 请检查isbn=值 (帮助)](https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-1)(中文(简体) ) - `he`: 希伯来语(基于ECMAScript国际化API数据) - `hu`: 匈牙利 (基于https://hu.wikipedia.org/wiki/ISO 639-1 nyelvkódok listája) - `id`: 印度尼西亚语(基于 [https://github.com/umpirsky/language-list/blob/master/data/id/language.json 互联网档案馆的存檔,存档日期2013-12-11](https://github.com/umpirsky/language-list/blob/master/data/id/language.json)(中文(简体) ) - `is`: Islandic (基于https://is.wikipedia.org/wiki/Listi yfir tungumálakóða %C3%AD ISO 639-1) - `it`: 意大利语( 基于 [https://github.com/umpirsky/language-list/blob/master/data/it/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/it/language.json)(中文(简体) ) - `ja`:日语(由专业翻译) - `ko`: 韩文(基于 [https://github.com/umpirsky/language-list/blob/master/data/ko/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/ko/language.json)(中文(简体) ) - `lt`: 立陶宛语(基于https://lt.wikipedia.org/wiki/Sárašas:ISO 639-1-kodai) 维基语录链接:名人名言 - 文学作品 - 谚语 - 谚语 - 谚语 - 谚语 - 谚语 - 谚语 - `lv`:拉脱维亚语(基于 [https://lv.wikipedia.org/wiki/ISO 639-1 kodu saraksts 互联网档案馆的存檔,存档日期2013-12-22](https://lv.wikipedia.org/wiki/ISO_639-1_kodu_saraksts)(中文(简体) ) - `ms`: 马来语( 基于 [https://github.com/umpirsky/language-list/blob/master/data/ms/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/ms/language.json)(中文(简体) ) - `nl`: 荷兰语(基于 [https://nl.wikipedia.org/wiki/Lijst van ISO 639-codes 互联网档案馆的存檔,存档日期2013-12-21](https://nl.wikipedia.org/wiki/Lijst_van_ISO_639-codes)(中文(简体) ) - `no`: 挪威语(基于 [https://no.wikipedia.org/wiki/Liste over ISO 639-1-koder (英语)](https://no.wikipedia.org/wiki/Liste_over_ISO_639-1-koder)(中文(简体) ) - `pl`: 波兰语(基于https://pl.wiktionary.org/wiki/Wikis%C5%82ownik:Kody j%C4%99zyk%C3%B3w) - `pt`: 葡萄牙语( 欧洲)(基于 [https://pt.wikipedia.org/wiki/ISO 639 (英语)](https://pt.wikipedia.org/wiki/ISO_639)(中文(简体) ) - `ro`: 罗马尼亚语(基于 [https://ro.wikipedia.org/wiki/Lista codurilor ISO 639-1 (英语)](https://ro.wikipedia.org/wiki/Lista_codurilor_ISO_639-1)(中文(简体) ) - `ru`: 俄语(由专业翻译) - `sk`: 斯洛伐克语(基于 [https://sk.wikipedia.org/wiki/ISO 639 (英语)](https://sk.wikipedia.org/wiki/ISO_639)(中文(简体) ) - `sv`: 瑞典语(基于 [https://sv.wikipedia.org/wiki/ISO 639 (英语)](https://sv.wikipedia.org/wiki/ISO_639)(中文(简体) ) - `th`: 泰语(基于 [https://github.com/umpirsky/ language-list/blob/master/data/th/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/th/language.json)(中文(简体) ) - `uk`: 乌克兰语(基于https://uk.wikipedia.org/wiki/Список мовних кодів -ISO 639) - `vi`: 越南语( 基于 [https://github.com/umpirsky/language-list/blob/master/data/vi/language.json 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/umpirsky/language-list/blob/master/data/vi/language.json)(中文(简体) ) - `zh`: 中文 (由专业翻译) [ISO 639-1 代码列表](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) ### 语言到代码 ```javascript 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) 代码 ```javascript 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) 代码 ```javascript 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) 代码 ```javascript var languages = require("@cospired/i18n-iso-languages"); console.log(languages.getAlpha2Codes()); // { 'aa': 'aar', 'ab': 'abk', [...], 'za': 'zha', 'zu': 'zul' } ``` ### 获取全部 ISO 639-2 (Alpha-3) 代码 ```javascript 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' } ``` ### 验证语言代码 ```javascript 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 是什么？ 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 和提交记录判断。