# i18n - 国际化

## i18n 介绍

i18n 是 internationalization(国际化) 的首尾字符加中间的 18 个字符，随着产品越做越大，要推向国际的时候，国际化这一步是必不可少的。i18n 的方案有很多，这里只讨论在 Chrome Extension 中的情况。

## i18n 在 Chrome Extension 中应用

Chrome Extension 的 i18n 很方便，基本就是按照下列步骤走。

1. 在 `manifest.json` 中添加 [default\_locale](https://github.com/welearnmore/chrome-extension-demos/blob/master/i18n/manifest.json#L9):

   ```javascript
   {
    "default_locale": "zh_CN"
   }
   ```
2. 在跟目录中新建 `_locales` 文件夹，并且在 [Choosing locales to support](https://developer.chrome.com/webstore/i18n?csw=1#localeTable) 中找到你要支持的语言，比如我们选择支持中文(zh\_CN)和英文(en)。然后在 `_locales` 文件夹中再新建 `en` 和 `zh_CN` 文件夹，并且分别在里面新建 `messages.json`:

   ```bash
   - _locales
    |- en
        | - messages.json
    |- zh_CN
        | - messages.json
   ```

   > 这里的 `locales` 、`en` 、`zh_CN`、`messages` 命名是一定要这样的，一个字母都不能错
3. 再来看 `messages.json` 的结构: [zh\_CN](https://github.com/welearnmore/chrome-extension-demos/blob/master/i18n/_locales/zh_CN/messages.json) 和 [en](https://github.com/welearnmore/chrome-extension-demos/blob/master/i18n/_locales/en/messages.json)
4. 使用：
   * 在 background 和 content\_scripts 中使用 [chrome.i18n.getMessage](https://developer.chrome.com/extensions/i18n#method-getMessage) 调取文案：

     ```javascript
     // 中文系统: hello 变量为 `你好`
     // 英文系统: hello 变量为 `Hi`
     const hello = chrome.i18n.getMessage('HELLO')
     ```

     ![zh](https://2936376509-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJldJ5SQnvMdIyYRWx5%2F-LK6JD8_9D4BRrWdD-8u%2F-LK6JDnDip0iK_bxuJOJ%2Fi18n-01.jpg?generation=1534499811290987\&alt=media) ![en](https://2936376509-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJldJ5SQnvMdIyYRWx5%2F-LK6JD8_9D4BRrWdD-8u%2F-LK6JDnFGs9hkILsyVpp%2Fi18n-03.jpg?generation=1534499821863152\&alt=media)

* 在 `manifest.json` 中插件名字和描述，格式为 `__MSG_${KEY}__`:

  ```javascript
  {
    "description": "__MSG_DESC__"
  }
  ```

  ![zh](https://2936376509-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJldJ5SQnvMdIyYRWx5%2F-LK6JD8_9D4BRrWdD-8u%2F-LK6JDnHtcVimYMKq-LH%2Fi18n-02.jpg?generation=1534499811322882\&alt=media) ![en](https://2936376509-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJldJ5SQnvMdIyYRWx5%2F-LK6JD8_9D4BRrWdD-8u%2F-LK6JDnJa777sV3V4HGO%2Fi18n-04.jpg?generation=1534499823281243\&alt=media)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lightningminers.gitbook.io/chrome-extension-book/index-2/i18n.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.