Skip to content

国际化 (i18n) ​

项目使用 vue-i18n 10,采用 Composition API 模式(legacy: false),共支持 5 种语言。

支持的语言 ​

语言代码语言文件
zh-CN简体中文(默认 / 回退语言)src/i18n/zh-CN.ts
zh-TW繁体中文src/i18n/zh-TW.ts
en-US英语src/i18n/en-US.ts
ja-JP日语src/i18n/ja-JP.ts
ru-RU俄语src/i18n/ru-RU.ts

初始化 ​

typescript
// src/i18n/index.ts
import { createI18n } from 'vue-i18n'
import zhCN from './zh-CN'
import enUS from './en-US'
import zhTW from './zh-TW'
import ruRU from './ru-RU'
import jaJP from './ja-JP'

const LOCALES = ['zh-CN', 'en-US', 'zh-TW', 'ru-RU', 'ja-JP'] as const
export type Locale = (typeof LOCALES)[number]

function getStoredLocale(): Locale {
  try {
    const stored = localStorage.getItem('hayfrp-locale')
    if (stored && (LOCALES as readonly string[]).includes(stored)) return stored as Locale
  } catch { /* ignore */ }
  return 'zh-CN'
}

const i18n = createI18n({
  legacy: false,
  locale: getStoredLocale(),
  fallbackLocale: 'zh-CN',
  messages: { 'zh-CN': zhCN, 'en-US': enUS, 'zh-TW': zhTW, 'ru-RU': ruRU, 'ja-JP': jaJP }
})

export function setLocale(locale: Locale) {
  (i18n.global.locale as { value: string }).value = locale
  localStorage.setItem('hayfrp-locale', locale)
}

export function getLocale(): string {
  return (i18n.global.locale as { value: string }).value
}

export default i18n
  • 语言偏好保存在 localStorage 的 hayfrp-locale
  • App.vue 同时切换 Naive UI 的 locale 与 date-locale(zhCN / enUS / zhTW / ruRU / jaJP 及对应 date*)
  • 路由守卫用 i18n.global.t(meta.titleKey) 生成页面标题,因此新增路由必须同时补 titleKey 文案

命名空间结构 ​

src/i18n/zh-CN.ts 按页面 / 功能分组,主要命名空间如下:

命名空间覆盖内容
common通用按钮与提示(保存、取消、复制配置、页面未找到等)
menu侧边栏菜单项(控制台、隧道管理、节点列表、云控、启动器授权、下载、关于、文档、首页、联机大厅)
header / mobile顶栏登录 / 注册按钮、移动端菜单
landing首页全部文案(Hero、能力、节点、流程、下载、FAQ、CTA、页脚)
login / register / auth登录(含扫码、重置密码)、注册、保留登录状态
dashboard控制台统计卡片、用户信息、流量、签到、交流群
proxies隧道管理的表格列、表单、简单启动、批量操作
lobby联机大厅房间、密码、密钥、聊天
nodes节点列表、探针详情、地图(世界 / 亚太 / 中国视图、城市级 / 国家地区级)
download版本信息、frpc / frps / 启动器 / Cli
about核心特性、技术栈、服务商、开发时间线
settings用户设置全部表单项与确认文案
preference个性化设置(菜单位置、移动端强制顶部)
customize面板个性化(主题色、背景色、紧凑模式、动画、二次元风格)
launcher启动器授权状态、说明、FAQ
cloudControl云控设备绑定、命令、日志、自启
serviceProvider服务商控制台全部文案
notification / redeem / bind / ad / cnRedirect通知中心、兑换码、账户绑定、广告位、国内跳转提示
i18n语言切换告警(英文界面测试中提示)

在组件中使用 ​

vue
<script setup lang="ts">
import { useI18n } from 'vue-i18n'
const { t } = useI18n()
</script>

<template>
  <NButton>{{ t('proxies.easyRun') }}</NButton>
  <span>{{ $t('nodes.onlineCount', { count: 12 }) }}</span>
</template>

约定

  • 模板中优先用 $t('key'),脚本中用 t('key')
  • 带插值的文案使用具名参数,如 nodes.onlineCount: '共{count}个节点在线'
  • 新增文案必须同时补齐 5 个语言文件,缺失时回退到 zh-CN

与 Naive UI 的联动 ​

vue
<NConfigProvider
  :theme="themeStore.theme"
  :locale="locale === 'en-US' ? enUS : locale === 'zh-TW' ? zhTW : locale === 'ru-RU' ? ruRU : locale === 'ja-JP' ? jaJP : zhCN"
  :date-locale="locale === 'en-US' ? dateEnUS : locale === 'zh-TW' ? dateZhTW : locale === 'ru-RU' ? dateRuRU : locale === 'ja-JP' ? dateJaJP : dateZhCN"
>
  <AppLayout />
</NConfigProvider>

SEO 与标题 ​

  • 路由守卫:document.title = \${t(titleKey)} - HayFrp``
  • SeoHead.vue 会进一步覆盖 title、meta description / keywords、Open Graph 与 canonical(仅针对 /、/dashboard、/proxies、/nodes、/download、/login、/register,其余路径回退到首页配置)

新增一种语言的步骤 ​

  1. 复制 src/i18n/zh-CN.ts 为 src/i18n/xx-XX.ts 并翻译
  2. 在 src/i18n/index.ts 的 LOCALES 中加入语言代码,并在 messages 中注册
  3. 在 App.vue 的 NConfigProvider 中补充该语言的 Naive UI locale / date-locale 映射
  4. 在 AppLayout.vue 语言选择器中加入选项
  5. 运行 npm run build(vue-tsc -b 会校验类型)

相关页面 ​

基于 MIT 许可证发布