---
order: 1
navTitle: 国际化
---
# 国际化

SuccBI支持国际化，默认有中文和英文这两种语言，可以解决不同地区客户访问系统的需求。

## 系统默认语言{#languageSetting}

系统默认支持简体中文和英语这两种语言。在**系统设置**>**更多**>**国际化**中可以配置默认语言设置，点击保存后，让设置生效。

![国际化](./images/i18n.png)

### 使用浏览器的语言设置{#useBrowserLanguage}

开启使用浏览器的语言设置后，若没有在个人设置中设置语言，系统会自动使用当前浏览器的语言设置。关闭该设置后，将会使用系统默认语言设置。

### 系统默认设置{#defaultLanguage}

系统优先使用个人设置中的语言设置，其次是对浏览器的语言设置，最后是系统的默认语言。

## 配置国际化代码{#i18nCode}

系统支持可以自定义国际化代码，选择其中一种语言，进入自定义页面添加需要自定义的国际化，也可以查阅相关国际化内容。

### 自定义国际化内容{#customizeContent}

可以在界面上自定义国际化的内容，操作包括：

- **增加国际化内容**，有两种操作方式：
  - 直接修改国际化的Value值，修改后会自动生成一条新的国际化键值对
  - 点击工具栏**新增**按钮，新增一条国际化，手动赋值，可以提前赋值好需要修改的Key
- **删除国际化内容**：修改过或者新增的国际化可以删除，选中某一条点击工具栏的**删除**按钮，即可删除。其中，系统默认的国际化是无法删除的
- **查询国际化内容**：在顶部工具栏右边的搜索框中直接输入想要搜索的内容即可
- **重置自定义国际化内容**：点击工具栏的**重置**按钮，会将当前语言的所有自定义国际化内容都删掉，请谨慎操作

![增删查改](./images/i18n.gif)

### 直接在约定位置增加国际化{#i18nDevelopment}

在国际化做一些自定义修改，比如增加自定义中文国际化、英文国际化，保存后会在系统数据`/sysdata/settings/`文件夹下生成一个i18n文件夹，文件夹内部文件形式如下：

```ts
├──custom.en.properties //自定义英文国际化
└──custom.zh_CN.properties //自定义中文国际化
```

如果在这里面直接修改了对应语言的i18n文件，在项目设置中的自定义国际化界面也可以看到修改后的国际化条目。

:::warning
i18n目录下的所有文件名称均为系统命名规范，不要重命名。否则系统是无法读出用户手动在文件中编辑的国际化
:::

:::tip 小知识
为什么用`i18n`来表示国际化呢:question:

i18n，其来源是英文单词`internationalization`的首末字符i和n，18为中间的字符数，是`国际化`的简称
:::