hotgo/docs/guide-zh-CN/sys-i18n.md

国际化

目录

• 介绍
• 配置文件
• 服务端使用
• Web端使用
• 更多文档

介绍

从v2.18.6版本开始，HotGo 提供了完善的国际化（i18n）支持，内置简体中文、繁体中文和英文三种语言包，默认语言为简体中文。目前已对后台管理首页进行了多语言适配，开发者可基于该机制扩展实现业务模块的多语言功能。

配置文件

国际化配置位于 server/manifest/config/config.yaml 文件中：

# hotgo系统配置
system:
  # ...
  # 国际化
  i18n:
    switch: true                                      # 国际化功能开关，可选值：false|true，默认：true
    defaultLanguage: "zh-CN"                          # 默认语言，可选值：zh-CN|zh-TW|en，默认：zh-CN

服务端使用

多语言配置文件存放目录：server/manifest/i18n，您可以在该目录下添加自定义的语言映射文件。

使用示例：

// 设置当前上下文的语言为英文
ctx := gctx.New()
gi18n.WithLanguage(ctx, "en")

// 基础翻译
gi18n.T(ctx, "你好，美丽世界")
// 输出：Hello, Beautiful World

// 格式化翻译（支持参数替换）
gi18n.Tf(ctx, "剩余%v余额", 100)
// 输出：Remaining 100 Balance

Web端使用

多语言配置文件存放目录：web/src/locale，您可以在该目录下添加自定义的语言映射文件。

提示：启用国际化功能后，后台管理界面右上角将显示语言切换选项。

使用示例（假设当前语言为英文）：

<!-- 基础翻译 -->
<div>{{ t('你好，美丽世界') }}</div>
<!-- 输出：Hello, Beautiful World -->

<!-- 格式化翻译（支持参数替换） -->
<div>{{ t('剩余{num}余额', {num:100}) }}</div>
<!-- 输出：Remaining 100 Balance -->

更多文档

• gi18n
• vie-i18n