构建时预渲染翻译内容指在构建阶段生成含真实译文的多语言静态html文件,而非运行时js替换;next.js需用generatestaticparams+dynamic="error",vite需配合prerender插件显式配置多语言路径,vue cli需确保无头浏览器能识别语言状态。

构建时预渲染翻译内容 ≠ 在 HTML 里加 lang 或 data-i18n
构建阶段预渲染翻译内容,是指在 npm run build 过程中,就生成带真实译文的完整 HTML 文件(比如 /en/about/index.html 和 /zh/about/index.html),而不是等用户点击语言切换按钮再用 JS 替换文本。这和运行时 i18n 完全不同——前者输出多套静态文件,后者只输出一套 HTML + 一套 JSON + 一堆 JS。
Next.js App Router 必须用 generateStaticParams + dynamic = "error"
如果你用 Next.js 13+ App Router,别写 prerender_html,也别手动调 Puppeteer。框架原生支持多语言静态生成,但必须满足两个硬条件:
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
-
generateStaticParams返回每种语言的组合,例如[{ lang: 'zh', slug: 'about' }, { lang: 'en', slug: 'about' }] - 对应页面组件顶部声明
export const dynamic = "error"(不是"force-static",那个已被废弃) - 路径结构要匹配:若想生成
/zh/about,路由文件必须是app/[lang]/about/page.tsx,且[lang]是动态段 - 构建后检查
out/zh/about/index.html是否真实存在并含中文文本——如果只有out/_next/目录,说明没生效
Vite + i18n 插件需配合 vite-plugin-prerender 手动触发多语言渲染
Vite 没有内置多语言 SSG 支持,i18n 插件(如 @inlang/paraglide-js)只管运行时切换,不生成多份 HTML。真要构建时预渲染,得自己驱动 vite-plugin-prerender:
- 不能只传
routes: ['/about'],得显式列出所有语言路径:routes: ['/zh/about', '/en/about'] - 确保每个路径请求能正确注入语言上下文——比如在
renderAfterTime里等window.__LANG__ = 'zh'被设好,或用 URL path 做判断 - 避免在
main.ts里写if (location.pathname.startsWith('/zh')) {...}—— 构建时无location,会出错 - 输出目录需按语言分隔,否则
/zh/about和/en/about会互相覆盖
Vue CLI 项目用 prerender-spa-plugin 时,语言状态必须可被无头浏览器识别
这个插件默认只跑一次 page.goto('/') ,没法自动切语言。你要么:
- 改写入口逻辑,在挂载前读取 URL path 或 hash 来决定语言,例如
const lang = location.pathname.split('/')[1] || 'zh' - 配置插件多次运行:为每种语言单独调一次
prerender-spa-plugin,staticDir指向不同子目录(如dist/zh、dist/en) - 禁用所有依赖客户端 localStorage 的语言检测逻辑——构建时 localStorage 是空的,会导致 fallback 到默认语言甚至报错
- 验证生成的 HTML 是否含真实译文:打开
dist/zh/index.html,搜索 “欢迎”;如果看到的是data-i18n="welcome"或空容器,说明预渲染失败
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










