你的 vibe 项目值得做 i18n：从硬编码到多语言上线的实战路线

什么时候值得做 i18n，什么时候别折腾

先说结论：想上 Product Hunt、想吃英文流量、想让项目被全世界 fork，就做——英文介绍的项目传播半径是中文的数倍。纯中文小工具、给自己用的效率脚本、验证阶段的 MVP——先别折腾，等有人问“有英文版吗”再说。

判断标准就一个：你的用户获取渠道里有没有英文世界。如果答案是“打算有”，那 i18n 越早做越便宜——项目 5000 行时抽文案是一下午的事，50000 行时就是一场战役。

第一步永远是：让 AI 把硬编码字符串抽成 key

i18n 的第一步不是翻译，是把散落在代码里的中文字符串全部抽出来。这活 AI 干得又快又好，给它一个明确的提示词：“扫描整个项目，把所有用户可见的硬编码中文字符串替换为 i18n key，不要动逻辑，不要动注释里的中文。”

key 命名规范：模块.位置.含义，比如 checkout.coupon.title、settings.profile.saveButton。别用 text1、msg_abc 这种——key 本身就是文档，三个月后你看到 key 就知道它出现在哪。

一条铁律：抽 key 时一个 key 只对应一处含义。“确定”在对话框里和在表单里可能是同一个词，但别复用同一个 key——英文里它们可能是 “OK” 和 “Confirm”，复用了就分不开了。

选型一句话：跟着你的框架走

Next.js 用 next-intl，React/Vite 用 react-i18next，Vue 用 vue-i18n——别纠结对比，跟着框架生态走就是最优解。语言文件放 locales/zh.json、locales/en.json，结构跟 key 的点分命名一一对应。

URL 策略也一句话：用路径区分语言（/zh/pricing、/en/pricing），对 SEO 最友好，也最符合用户直觉。

AI 翻译初稿 + 人工校对：千万别省第二步

流程分三步：AI 翻初稿 → 你（或母语者）校对产品文案 → 上线后收集反馈再修。AI 翻 UI 文案的质量已经足够好，但有两类文案千万别让 AI 直翻了就上线：法律条款和支付相关文案——“订阅”和“购买”在英文里是两个完全不同的法律含义，翻错了是真会出事的。

校对时重点看三类地方：按钮文案（英文通常比中文长，会不会撑破布局）、空状态和报错文案（AI 翻得最随意的地方）、营销话术（直译的中文营销话术在英文里读起来像诈骗短信）。

一个省钱的技巧：先让 AI 翻译，然后让另一个 AI（或同一个 AI 换个 prompt）扮演英语母语用户，把翻译后的界面文案挑刺一遍。机器互审能抓住 80% 的别扭表达，剩下 20% 靠真人。

四个坑，个个都见过血

坑一：复数规则。中文没有单复数，英文有。别写 {n} message(s) 这种偷懒写法，用 i18n 库的复数功能——阿拉伯语有 6 种复数形式，你 hardcode 一个 s 就等着被骂。

坑二：日期、货币、数字格式。2026/10/06 在美国人眼里是 10 月 6 日还是 6 月 10 日？用 Intl.DateTimeFormat 和 Intl.NumberFormat，别自己拼字符串。

坑三：字符串拼接。“你有” + n + “条消息” 在中文里成立，在英文里语序是 “You have n messages”——拼接在目标语言里会断成三截。用带插值的完整句子：t('inbox.count', {n})。

坑四：图片里的文字。Logo、截图、教程配图里的中文，切换语言后还在。检查一遍所有静态资源，该做多语言版本的做版本，该换成纯图标的换图标。

验收清单：切换语言后点一遍核心流程

上线前的验收很简单：把语言切到英文，从头到尾点一遍核心流程——注册、核心功能、支付、设置。checklist 只有四项：有没有漏翻的中文、有没有撑破布局的长文案、有没有拼接断裂的句子、有没有 404（漏配的 key）。

最后说个判断：i18n 是 vibe 项目性价比最高的增长动作之一——AI 把“抽取→翻译→校对”这条链路的成本降到了几乎为零，而英文介绍带来的传播半径是实打实的。一个下午的投入，换来的是全世界的用户，这买卖值得做。