國際化 (i18n)
優先級:P2 (中等)
維護語言代碼的單一事實來源,並確保 SEO 友善的子路徑路由。
實作指南
- 語言路由:遵循以 URL 優先的方法以利 SEO。在 App Router 中使用動態區段 (例如
app/[lang]/page.tsx),並在 Pages Router 中使用next.config.js中的i18n設定。 - 函式庫選擇:對 App Router (現代) 使用
next-intl,對舊版應用程式使用react-intl或next-translate。 - 語言偵測:實作中介軟體本地化 (位於
middleware.ts),從Accept-Language標頭或 Cookie 偵測使用者語言,並執行重新導向。 - 伺服器端:在伺服器元件中載入翻譯**
messages/*.json** 字典,以保持客戶端套件小巧。使用getMessages()或requestConfig模式。 - SEO:確保透過
metadataAPI 為所有已翻譯路由正確產生hreflang標籤。 - 靜態生成:使用
generateStaticParams在建置時預先渲染靜態頁面的本地化版本。module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. 函式庫細節
如需常用函式庫的詳細設定,請參閱:
反模式
- 不要在 JSX 中寫死字串:使用翻譯鍵;絕不提交原始文字。
- 不要使用客戶端翻譯套件:使用
getMessages()在伺服器端載入字典。 - 不要混合使用不同的 URL 語言模式:一致地使用子路徑或子網域。