Vite+i18next脚手架核心是简化重复配置：用npm create vite初始化，按locales/zh/translation.json组织语言包，通过import.meta.glob动态加载，t('key')替代硬编码，同步初始化+URL/lang属性控制避免闪烁，本地预览须用HTTP服务而非file://协议。
用 Vite + i18next 快速搭起多语言开发流
脚手架不是为了炫技，而是把重复配置压成一行命令。Vite 启动快、HMR 稳、插件生态轻量，配合 i18next 的模块化设计，能跳过 Webpack 配置、手动资源加载、语言切换状态管理这些老坑。
实操建议：
- 初始化项目时直接用
npm create vite@latest my-app -- --template react，不选 TypeScript 也能后续加，别卡在“必须配全”上 - 安装
i18next和react-i18next，但**不要立即引入i18next-browser-languagedetector**——毕业设计或小项目里，浏览器语言检测常不准，优先用 URL 参数（如/zh/home）或 localStorage 显式控制更可控 - 语言包按
locales/zh/translation.json、locales/en/translation.json组织，用 Vite 的import.meta.glob动态加载，避免打包进所有语言 - 组件内用
t('button.submit')而非硬编码，但别在useEffect里反复调t，它本身是纯函数，无需依赖追踪
HTML 中 data-i18n 属性怎么避免 DOM 闪烁？
客户端渲染下，文本从默认语言闪到目标语言，本质是 JS 加载和执行的延迟。这不是 bug，是机制限制，但可以收窄影响范围。
关键点：
立即学习“前端免费学习笔记（深入）”；
-
data-i18n只用于静态文本，动态内容（如用户昵称、时间戳）必须走 JS 渲染逻辑，否则无法格式化复数、日期等 - 不要等整个
document.ready再初始化 i18next，改用i18next.init({ fallbackLng: 'en', lng: getLangFromUrl() })同步启动，配合load: 'languageOnly'减少初始加载体积 - 服务端若能输出
<html lang="zh">，就别靠 JS 改document.documentElement.lang，CSS 的:lang(zh)选择器才能立刻生效 - 如果必须支持 JS 禁用场景，就把核心文案写进 HTML 注释里，用 JS 激活时再移除注释并填充——虽然麻烦，但比白屏友好
脚手架里怎么自动化处理多语言路径和 hreflang？
毕业设计部署到 GitHub Pages 或静态托管时，/en/ 和 /zh/ 这类子目录不是靠手动复制文件夹解决的，得让构建过程生成对应结构。
推荐做法：
- Vite 插件写个简单的
build:multilang脚本：读取locales目录下所有语言文件夹，对每个语言生成一份index.html，并注入<link rel="alternate" hreflang="zh" href="/zh/">标签 - 路由不走前端 router，用纯静态路径，这样搜索引擎能直接抓取不同语言页；
404.html里加 JS 跳转逻辑兜底，避免死链 - 避免用
location.pathname解析当前语言，改成从document.currentScript?.src或预埋的window.__LANG__获取，防止路径被重写后失准 - 每次新增语言，只需往
locales加个文件夹，不用改任何构建配置——这才是脚手架该干的事
为什么本地预览 HTML 国际化总失败？
根本原因不是代码写错了，而是浏览器用 file:// 协议打开时，XMLHttpRequest / fetch 会因跨域被拦截，语言 JSON 文件加载失败，i18next 初始化卡在 pending 状态。
必须换方式预览：
- VS Code 安装
Live Server插件，右键 HTML 文件选 “Open with Live Server”，它起的是http://127.0.0.1:5500本地服务，绕过限制 - 命令行临时起服务也行：
npx http-server -p 8080，但注意它默认不支持 SPA fallback，多语言子目录要手动配-c-1关闭缓存才方便调试 - 别信某些教程说“Chrome 启动加
--allow-file-access-from-files”，这个 flag 在新版 Chrome 已废弃，强行启用反而触发更严的安全策略 - 检查浏览器控制台的 Network 面板，确认
locales/zh/translation.json请求返回 200，而不是 404 或 blocked
国际化最难的从来不是翻译，而是让语言切换这件事，在构建、部署、调试三个环节都不掉链子。脚手架的价值，就是把那些需要人肉核对的路径、标签、请求头，变成一次 npm run build 就能覆盖的确定性输出。别在 webpack.config.js 里折腾 loader 链了，Vite 的 import.meta.glob 和插件 API 更直给。
