Cool Unix

主题

国际化多语言 ​

Cool Unix 内置强大的国际化插件，支持多语言切换和 AI 智能翻译，助力您的应用走向全球市场。

重要提示

本页内容基于 cool-unix@8.0.16，翻译方案已全面升级。建议及时拉取最新代码，体验更高效的多语言支持。

  • 更新依赖 @cool-vue/ai 版本 1.1.6 以上
  • 更新依赖 @cool-vue/vite-plugin 版本 8.2.7 以上

🌍 特性概览 ​

  • 🤖 AI 智能翻译 - 基于人工智能的自动翻译服务
  • 🔄 动态语言切换 - 运行时无缝切换语言
  • 📝 占位符支持 - 支持参数化翻译内容
  • 🌐 广泛语言支持 - 内置 50+ 种语言配置

⚙️ 配置设置 ​

基础配置 ​

在项目根目录的 /locale/index.ts 文件中配置需要的语言：

js
import zhcn from "./zh-cn.json";
import zhtw from "./zh-tw.json";
import en from "./en.json";
import es from "./es.json";
import ja from "./ja.json";
import ko from "./ko.json";
import fr from "./fr.json";

/**
 * 语言包映射对象，包含所有已支持的语言。
 * 如需新增语言，只需新建对应的 xx.json 文件并在此处引入即可。
 */
const messages = {
  "zh-cn": parse(zhcn),
  "zh-tw": parse(zhtw),
  en: parse(en),
  es: parse(es),
  ja: parse(ja),
  ko: parse(ko),
  fr: parse(fr),
};

重要说明 ​

🔍 翻译语言数量

messages 中配置的语言数量将决定 AI 翻译时同时处理的语言数量。建议根据项目需求合理配置，避免不必要的翻译成本。

配置完成后，执行 npx cool-i18n create 命令可触发 AI 翻译，自动更新 locale 目录下的语言文件。对于翻译不准确的内容，建议手动调整优化。

📝 使用指南 ​

基础用法 ​

所有需要翻译的文本内容都需要使用 t() 或 $t() 函数包装：

html
<!-- 模板中使用 -->
<text>{{ t('你好') }}</text>
<text>{{ $t('欢迎{name}', { name: '张三' }) }}</text>

脚本中使用 ​

html
<script setup lang="ts">
  import { t, $t } from "/@/locale";

  // 基础翻译
  ui.showToast({
    message: t("操作成功"),
  });

  // 参数化翻译
  ui.showToast({
    message: $t("欢迎回来，{name}", { name: "李四" }),
  });
</script>

函数说明 ​

函数语法功能使用场景
t()t(text)基础翻译静态文本内容
$t()$t(text, data)参数化翻译动态内容，支持占位符

为什么不使用可选参数 data? ，在 帮助文档 中会说明。

最佳实践 ​

  • 使用中文作为源语言: AI 系统会自动检索中文内容并翻译成其他语言
  • 保持文本简洁: 避免过长的文本，便于翻译和维护
  • 合理使用占位符: 对于动态内容使用 {参数名} 格式

🤖 AI 翻译工具 ​

项目已默认集成相关工具依赖，只需在项目根目录下执行以下命令：

bash
# 创建/更新翻译文件
npx cool-i18n create

# 添加 uni_modules 下的语言
npx cool-i18n add uni_modules/[name]

工作流程 ​

  1. 扫描源码 - 工具会自动扫描项目中的 t() 和 $t() 函数
  2. 提取文本 - 收集所有需要翻译的中文文本
  3. AI 翻译 - 调用 AI 服务翻译成目标语言
  4. 生成文件 - 在相应目录下生成 locale 翻译文件

输出结构 ​

项目根目录/
└── locale/
    ├── zh-cn.json      # 简体中文
    ├── zh-tw.json      # 繁体中文
    ├── en.json         # 英语
    └── es.json         # 西班牙语

🌐 支持的语言 ​

主要语言 ​

语言代码地区
简体中文zh-cn `中国大陆
繁体中文zh-tw中国台湾
英语en美国
日语ja日本
韩语ko韩国

欧洲语言 ​

语言代码语言代码
德语de法语fr
西班牙语es意大利语it
葡萄牙语pt荷兰语nl
俄语ru波兰语pl
瑞典语sv丹麦语da
挪威语nb-NO芬兰语fi
希腊语el捷克语cs
匈牙利语hu罗马尼亚语ro

其他地区语言 ​

点击查看完整语言列表
语言代码语言代码
阿拉伯语ar希伯来语he
土耳其语tr波斯语fa
泰语th越南语vi
印度尼西亚语id马来语ms
孟加拉语bn泰米尔语ta
乌克兰语uk保加利亚语bg
克罗地亚语hr塞尔维亚语sr
斯洛伐克语sk斯洛文尼亚语sl
立陶宛语lt拉脱维亚语lv
爱沙尼亚语et加泰罗尼亚语ca
巴斯克语eu世界语eo
库尔德语ku / ckb亚美尼亚语hy-am
阿塞拜疆语az哈萨克语kk
吉尔吉斯语ky蒙古语mn
土库曼语tk维吾尔语ug-cn
高棉语km南非荷兰语af
普什图语pa巴西葡萄牙语pt-br