WuEasy Gateway

外观

国际化配置指南 🌍 ​

什么是国际化？ 🤔 ​

想象国际化就像是一个多语言翻译官：

  • 🗣️ 能听懂不同的语言（接收多语言请求）
  • 📝 按需切换语言（动态切换消息）
  • 🌐 支持多国语言（多语言配置）
  • 📢 准确传达信息（本地化响应）

基础配置 ⚙️ ​

1. 默认语言设置 ​

就像设置翻译官的母语：

yaml
wueasy:
  i18n:
    defaultLanguage: zh  # 设置默认语言为中文

2. 支持的语言 ​

可选的语言代码列表：

语言代码说明使用场景
cn中文简体中文环境
zh中文简体中文环境
zh_CN中文（中国大陆）中国大陆地区
en英文英语环境
en_US英文（美国）美国地区

使用方法 📝 ​

1. 请求头设置 ​

在请求中设置语言：

http
# 设置请求头
wueasy-language: zh

2. API调用示例 ​

bash
# 中文请求示例
curl -H "wueasy-language: zh" http://your-api-endpoint

# 英文请求示例
curl -H "wueasy-language: en" http://your-api-endpoint

最佳实践 💫 ​

1. 语言选择建议 ​

  • ✓ 使用标准的语言代码
  • ✓ 设置合适的默认语言
  • ✓ 提供完整的语言支持

2. 性能优化 ​

  • ✓ 缓存常用消息
  • ✓ 按需加载语言包
  • ✓ 合理设置缓存策略

常见问题 ❓ ​

1. 语言未切换？ ​

检查以下几点：

  • ✓ 请求头是否正确设置
  • ✓ 语言代码是否支持
  • ✓ 配置是否生效

2. 消息未翻译？ ​

解决方案：

  • ✓ 检查语言文件是否存在
  • ✓ 验证消息键是否正确
  • ✓ 确认语言代码匹配

调试技巧 🔍 ​

1. 查看当前语言 ​

bash
# 获取当前语言设置
curl -H "wueasy-language: zh" http://your-api/system/locale

2. 测试不同语言 ​

bash
# 测试中文
curl -H "wueasy-language: zh" http://your-api/test/message

# 测试英文
curl -H "wueasy-language: en" http://your-api/test/message

需要帮助？🆘 ​

如果遇到问题：

  1. 检查配置文件
  2. 查看请求头
  3. 验证语言文件
  4. 联系技术支持

Copyright © 2017-2025 wueasy.com