国际化 (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,其余路径回退到首页配置)
新增一种语言的步骤
- 复制
src/i18n/zh-CN.ts为src/i18n/xx-XX.ts并翻译 - 在
src/i18n/index.ts的LOCALES中加入语言代码,并在messages中注册 - 在
App.vue的NConfigProvider中补充该语言的 Naive UIlocale/date-locale映射 - 在
AppLayout.vue语言选择器中加入选项 - 运行
npm run build(vue-tsc -b会校验类型)