手写i18n层对比:bloub为何拒绝vue-i18n,用240行代码实现三语支持

发布时间:2026/10/11 11:11:24
手写i18n层对比:bloub为何拒绝vue-i18n,用240行代码实现三语支持 前端图形学【免费下载链接】bloubSVG recreation of the x.ai bot avatar. One shape morphing through 14 states, measured off the reference video frame by frame.项目地址https://gitcode.com/gh_mirrors/bl/bloub点击查看免费下载bloub是一个用 SVG 复刻 x.ai 机器人头像的 Vue 3 小项目一个黑色图形在 14 种状态间形变表情、颜色、形状都能自定义。它的多语言功能没有使用 vue-i18n而是用src/i18n/目录下约 240 行手写 TypeScript 实现了法、英、中三语支持——这是量出来的取舍而非固执己见。先上对比数据为什么值得手写方案gzip 体积语言能力未知键检查vue-i18n34.4 kB日期、货币、复数、懒加载…运行时才发现bloub 手写层0.55 kB3 种语言、约 90 条文案编译期报错项目里没有任何日期或货币格式需求只有 3 种语言、约 90 条文案。为一个如此小的需求引入 34.4 kB 的依赖bloub 的答案是否。数据出处docs/i18n.md。手写层的全部家当src/i18n/index.ts —— 入口语言切换与t()函数src/i18n/langues.ts —— 语言定义与检测规则刻意不碰 DOMsrc/i18n/format.ts —— 插值与复数机制纯函数易于测试src/i18n/locales/fr.ts / en.ts / zh.ts —— 三语字典src/i18n/i18n.test.ts —— 完整性测试fr.ts 是契约漏翻译直接编译失败三个字典中最巧的设计fr.ts 是参考字典en和zh的类型都被声明为typeof fr你在fr.ts里新增一个键 →vue-tsc立刻在en.ts、zh.ts报编译错误漏翻译根本进不了 CI而t(reglage.x)这样的调用因为键名不存在同样编译不通过——vue-i18n 只能到运行时才发现。两个容易被忽视的细节千万不要给fr.ts加as const那样每个值都会变成字面量类型所有翻译都会被拒绝英文字符串不是法文字符串键名本身也有类型t()的签名只接受fr.ts里真实存在的键路径。语言检测检测 ≠ 记忆langues.ts 里的choisirLangue规则很克制显式选择永远优先——用户手动切过英文不会因为换了网络就变回法语否则按顺序遍历navigator.languages这是偏好排序不是集合取第一个会说的标签解析走Intl.Locale而非split(-)[0]这样zh-Hans-CN能正确落到zh全都不匹配时回退到默认法语。关键设计自动检测到的语言不写入 localStorage只有用户明确选择才通过 stockage.ts 持久化。否则一个首次从海外访问的用户语言会被冻结永远改不回来。语言列表刻意用内名Français / English / 简体中文而非翻译名——语言列表本来就是给看不懂该语言的人看的翻译它没有意义。复数与数字交给 Intl别自己拼format.ts只解决两件事插值{name}占位符替换没有提供值的占位符原样保留屏幕上看得见比空字符串更容易排查复数法语把 0 归为单数0 animation英语归为复数0 animations中文没有复数。字典里用|分隔单复数形式由Intl.PluralRules裁决而不是n 1。数字格式同理——法语小数用逗号、英语用点中文单位前不加空格。bloub 用带缓存的Intl.NumberFormatnombre/pourcentage/secondes而不是.replace(., ,)式的土办法。顺带一提timeline.ts 保持纯函数所有本地化格式化都从/i18n走模块间零耦合。标点符号属于翻译不属于代码这是文档里最较真的一条法语要« … »加不间断空格英语要…中文要全角标点且单位前不留空格。如果某个组件自己往文案前面拼一个«三种语言立刻坏掉两种。所以引号、空格、标点全部写进字典里由 zh.ts 这类文件自行承载。这些状态名Idle / 待机 / 眨眼……就来自字典的states目录在 BlockPicker.vue、Timeline.vue 等组件中通过t()渲染全项目共207 处t()调用。还有一处精妙设计未命名的动画序列不存 Default cycle 字符串而是存空串显示时经nomDeCycle()解析——这样默认名会跟随当前语言。写死名字的话首次访问写入 localStorage 后就变成了用户数据换语言也不会再翻译。什么时候该换回 vue-i18n作者没有留模糊地带docs/i18n.md 明确列出了切换门槛需要懒加载语言包首屏变重时语言超过10 种出现非开发者译者需要消息平台、XLIFF 流程等工具链。届时只需重写src/i18n/内部207 处调用方一行都不用动——这就是把接口收敛在 240 行里的价值。小结问题bloub 的答案键名打错 / 漏翻译typeof fr 路径类型编译期拦截语言检测尊重显式选择 按序匹配 默认法语复数差异Intl.PluralRules字典里|分形式数字与标点Intl 写进翻译代码零拼接何时换 vue-i18n懒加载 / 10 语言 / 非开发者译者对个人项目够用 类型安全 体积极小往往比引入成熟库更划算。240 行不是偷懒而是把复杂度花在了刀刃上。想跑起来看看克隆仓库后执行pnpm install pnpm dev打开浏览器即可切换三种语言。赞分享前端图形学【免费下载链接】bloubSVG recreation of the x.ai bot avatar. One shape morphing through 14 states, measured off the reference video frame by frame.项目地址https://gitcode.com/gh_mirrors/bl/bloub点击查看免费下载相关推荐Vue I18n 国际化插件完整指南如何为Vue应用添加多语言支持Vue I18n 国际化插件完整指南如何为Vue应用添加多语言支持 Vue I18n 是 Vue.js 的官方国际化插件让开发者能够轻松为应用程序添加多语言前端国际化Stylis核心组件详解Parser、Tokenizer和Serializer的工作原理Stylis核心组件详解Parser、Tokenizer和Serializer的工作原理 Stylis作为一款轻量级CSS预处理器其核心功能由ParserQQ空间说说备份用GetQzonehistory免费备份全部历史说说QQ空间说说备份用GetQzonehistory免费备份全部历史说说 打开QQ空间网页把说说往早年翻互动列表只展示有限页数更老的内容往往不在列表里。Get网页爬虫数据分析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询