국제화(i18n)
우선순위: P2 (중간)
로캘에 대한 단일 진실 공급원을 유지하고 SEO 친화적인 하위 경로 라우팅을 보장합니다.
구현 지침
- 로캘 라우팅: SEO를 위해 URL 우선 접근 방식을 따릅니다. App Router에서는 동적 세그먼트(예:
app/[lang]/page.tsx)를 사용하고, Pages Router에서는next.config.js의i18n설정을 사용합니다. - 라이브러리 선택: App Router(최신)에는 **
next-intl**을 사용하고, 레거시 앱에는react-intl또는 **next-translate**를 사용합니다. - 감지: 미들웨어 현지화(**
middleware.ts**에서)를 구현하여Accept-Language헤더 또는 쿠키에서 사용자 언어를 감지하고 리디렉션을 수행합니다. - 서버사이드: 클라이언트 번들을 작게 유지하기 위해 서버 컴포넌트에서 번역
messages/*.json사전을 로드합니다.getMessages()또는requestConfig패턴을 사용합니다. - SEO: 모든 번역된 경로에 대해
metadataAPI에서hreflang태그가 올바르게 생성되도록 합니다. - 정적 생성: **
generateStaticParams**를 사용하여 빌드 시 정적 페이지의 현지화된 버전을 미리 렌더링합니다.module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. 라이브러리 세부 사항
일반적인 라이브러리를 사용한 자세한 설정은 다음을 참조하세요.
안티 패턴
- JSX에 하드코딩된 문자열 금지: 번역 키를 사용하며, 원시 텍스트를 커밋하지 마세요.
- 클라이언트 측 번역 번들 금지:
getMessages()를 사용하여 서버에서 사전을 로드하세요. - 혼합 URL 로캘 패턴 금지: 하위 경로 또는 도메인을 일관되게 사용하세요.