# @dior/i18n-iso-countries 中文文档

规范地址：https://npmcn.com/package/%40dior/i18n-iso-countries/

版本：4\.2\.12
npm 元数据更新时间：2025-01-14T13:31:37.245Z
中文译文更新时间：2026-11-13T07:16:18.665Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dior/i18n-iso-countries
原文对照：https://npmcn.com/package/%40dior/i18n-iso-countries/?lang=original
项目主页：https://github.com/michaelwittig/node-i18n-iso-countries#readme
源码仓库：https://github.com/michaelwittig/node-i18n-iso-countries

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

- 包体积（解压后）：412 kB，64 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 6
- 运行依赖：1 个
- 首次发布：2019-07-24T09:00:11.013Z
- 最新版本发布：2025-01-14T13:31:36.995Z
- 近 30 天下载量：2137（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 0 个）

## 中文简介

iSO 3166-1 国家代码的i18n

## 安装

```sh
npm install @dior/i18n-iso-countries
```

也可以使用：`pnpm add @dior/i18n-iso-countries`、`yarn add @dior/i18n-iso-countries`、`bun add @dior/i18n-iso-countries`

## README

[![Build Status](https://secure.travis-ci.org/michaelwittig/node-i18n-iso-countries.png)](http://travis-ci.org/michaelwittig/node-i18n-iso-countries) [![NPM version](https://badge.fury.io/js/i18n-iso-countries.png)](http://badge.fury.io/js/i18n-iso-countries)

# i18n-同位素国家

> 版本4放弃了对节点4和5的支持!

i18n用于ISO 3166-1国家代码. 我们支持Alpha-2,Alpha-3和数字代码来自 [http://en.wikipedia.org/wiki/ISO 3166-1# 官方授权 编码 要素](http://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements)

## 安装

使用 npm 安装 : `npm install i18n-iso-countries`

```javascript
var countries = require("i18n-iso-countries");
```

如果您使用 `i18n-iso-countries` 和Node. j. 结束了。 如果您在浏览器环境中使用软件包,您还必须注册您想要使用的语言以最小化文件大小 .

```javascript
// Support french & english languages.
countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
countries.registerLocale(require("i18n-iso-countries/langs/fr.json"));
```

## 代码到国家

### 以 ISO 3166-1- Alpha-2、 Alpha-3 或数字代码获取一个国家的名称

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("US (Alpha-2) => " + countries.getName("US", "en")); // United States of America
console.log("US (Alpha-2) => " + countries.getName("US", "de")); // Vereinigte Staaten von Amerika
console.log("USA (Alpha-3) => " + countries.getName("USA", "en")); // United States of America
console.log("USA (Numeric) => " + countries.getName("840", "en")); // United States of America
```

### 使用 ISO 3166-1 Alpha-2 代码获取所有名称

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getNames("en")); // { 'AF': 'Afghanistan', 'AL': 'Albania', [...], 'ZM': 'Zambia', 'ZW': 'Zimbabwe' }
```

### 支助语言(ISO 639-1)

-   `ar`阿拉伯文
-   `az`: 阿塞拜疆语
-   `be`页: 1
-   `bg`: 保加利亚语
-   `bs`波斯尼亚语
-   `ca`: 加泰罗尼亚语
-   `cs`捷克语
-   `da`: 丹麦语
-   `de`: 德语
-   `en`页:1
-   `es`西班牙语
-   `et`: 爱沙尼亚语
-   `fa`: 波斯语
-   `fi`:芬兰语
-   `fr`法语
-   `el`: 希腊语
-   `he`希伯来语:
-   `hr`: 克罗地亚
-   `hu`: 匈牙利语
-   `hy`: 亚美尼亚语
-   `it`: 意大利语
-   `id`副主席: 印度尼西亚
-   `ja`: 日语
-   `ka`页:1
-   `kk`哈萨克语:
-   `ko`韩文:
-   `ky`吉尔吉斯斯坦语:
-   `lt`立陶宛语
-   `lv`: 拉脱维亚语
-   `mk`马其顿语
-   `mn`蒙古语:
-   `nb`挪威语: Bokmål
-   `nl`: 荷兰语
-   `nn`挪威尼诺尔斯克
-   `pl`波兰语
-   `pt`葡萄牙语
-   `ro`: 罗马尼亚
-   `ru`页:1
-   `sk`斯洛伐克语
-   `sl`: 斯洛文尼亚
-   `sr`塞尔维亚语
-   `sv`: 瑞典语
-   `tr`页:1
-   `uk`乌克兰语
-   `ur`: 乌尔都语
-   `uz`乌兹别克语
-   `zh`中文
-   `vi`: 越南语
-   `tw`台湾
-   `hk`: 洪刚

[ISO 639-1 代码列表](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)

### 国家到代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("United States of America => " + countries.getAlpha2Code('United States of America', 'en'));
// United States of America => US

console.log("United States of America => " + countries.getAlpha3Code('United States of America', 'en'));
// United States of America => USA
```

## 代码

### 将 Alpha-3 转换为 Alpha-2 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("USA (Alpha-3) => " + countries.alpha3ToAlpha2("USA") + " (Alpha-2)");
// USA (Alpha-3) => US (Alpha-2)
```

### 将数字转换为 Alpha-2 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("840 (Numeric) => " + countries.numericToAlpha2("840") + " (Alpha-2)");
// 840 (Numeric) => US (Alpha-2)
```

### 将 Alpha-2 转换为 Alpha-3 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("DE (Alpha-2) => " + countries.alpha2ToAlpha3("DE") + " (Alpha-3)");
// DE (Alpha-2) => DEU (Alpha-3)
```

### 将数字转换为 Alpha-3 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log("840 (Numeric) => " + countries.numericToAlpha3("840") + " (Alpha-3)");
// 840 (Numeric) => USA (Alpha-3)
```

### 将 Alpha-3 转换为数字代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha3ToNumeric("SWE"));
// 752
```

### 将 Alpha-2 转换为数字代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha2ToNumeric("SE"));
// 752
```

### 获取所有 Alpha-2 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getAlpha2Codes());
// { 'AF': 'AFG', 'AX': 'ALA', [...], 'ZM': 'ZMB', 'ZW': 'ZWE' }
```

### 获取所有 Alpha-3 代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getAlpha3Codes());
// { 'AFG': 'AF', 'ALA': 'AX', [...], 'ZMB': 'ZM', 'ZWE': 'ZW' }
```

### 获取全部数字代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getNumericCodes());
// { '004': 'AF', '008': 'AL', [...], '887': 'YE', '894': 'ZM' }
```

### 验证国家代码

```javascript
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.isValid("US"), countries.isValid("USA"), countries.isValid("XX")));
// true, true, false
```

## 捐款

要添加语言:

-   在 langs/ 下添加一个 json 文件
-   将语言添加到 `data` 位于顶端的enty-node.js中的对象
-   在区域中添加语言 **支持的语言** 在读取中
-   在软件包中添加语言到关键字. json
-   运行 `npm install && make test` 确保考试通过
-   在 GitHub 上打开 PR

您可以在此检查代码 : [https://www.iso.org/obp/ui/#home (英语)](https://www.iso.org/obp/ui/#home)

## 常见问题

### @dior/i18n-iso-countries 是什么？

iSO 3166-1 国家代码的i18n

### 如何安装 @dior/i18n-iso-countries？

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

### @dior/i18n-iso-countries 支持 TypeScript 吗？

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

### @dior/i18n-iso-countries 支持 ESM 还是 CommonJS？

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

### @dior/i18n-iso-countries 需要什么版本的 Node\.js？

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

### @dior/i18n-iso-countries 可以商用吗？

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

### @dior/i18n-iso-countries 的下载量有多少？

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

### @dior/i18n-iso-countries 还在维护吗？

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