Next.js i18n

Next.js i18n 구현 범위

국제화는 URL locale, 번역 리소스, 날짜·숫자 포맷, hreflang, 기본 언어 fallback을 함께 맞추는 구조다.

01

locale 모델

지원 언어, 기본 언어, URL에 locale을 노출할지 먼저 정한다.

locale policy
02

라우트 연결

next.config 또는 App Router segment와 middleware로 언어별 경로를 매핑한다.

routing
03

번역 로드

페이지와 컴포넌트가 필요한 namespace만 읽어 초기 payload를 줄인다.

messages
04

SEO 정리

언어별 metadata, canonical, hreflang을 연결해 중복 콘텐츠 신호를 줄인다.

localized SEO
URL
경로에 locale이 보이면 공유와 검색 엔진 인덱싱이 명확해진다. 자동 감지는 사용자 편의와 URL 안정성 사이 균형이 필요하다.
/ko, /en
번역
문자열을 코드에 직접 박지 않고 key와 namespace로 관리한다. 동적 값은 pluralization과 interpolation 규칙을 함께 둔다.
message catalog
SEO
같은 콘텐츠의 언어 버전은 hreflang으로 서로 연결한다. metadata도 언어별 검색 의도에 맞게 번역한다.
alternate links

i18n 구현 점검

fallback 번역 키 누락 시 운영 화면에 key 문자열이 그대로 노출되지 않는다.
포맷 날짜, 통화, 숫자가 locale 기준으로 표시된다.
링크 언어 전환이 현재 페이지 맥락을 유지한다.

언어 축

locale route -> message namespace -> localized metadata -> hreflang alternates