🔧개발💪도전

다국어 지원 시스템 구축 중

2025년 8월 25일

4분

Park Labs 웹사이트에 다국어 지원 시스템을 구축하고 있다. 한국어, 영어, 일본어 3개 언어 지원. next-intl 사용.

웹사이트에 다국어(i18n)를 넣고 있다.

uranai-musume가 일본 타겟이고, 앞으로 글로벌도 생각하면 처음부터 다국어 구조를 잡아놓는 게 맞겠다 싶어서 시작했다.

🛠️ 진행 상황

1. next-intl 설정 완료

/ko, /en, /ja 라우팅 구조

언어별 메시지 파일 분리

언어 선택기 구현

2. 번역 작업

한국어 ✅ 영어 ✅ 일본어 ✅

번역 자체는 금방 했는데, 모든 컴포넌트에 적용하는 게 은근 손이 많이 간다

3. 삽질한 것들

Next.js params가 Promise 타입으로 바뀌면서 타입 에러가 터졌다. 공식 문서 한참 뒤져서 해결.

SSG와 다국어 라우팅 조합이 까다로웠다. generateStaticParams에서 locale 조합을 다 만들어줘야 하는데 처음엔 몰라서 빌드 에러 몇 번 봤다.

Cloudflare Pages에서 locale redirect 설정하는 것도 좀 헤맸다.

🌏 왜 3개 언어인가?

일본어: uranai-musume 프로젝트 때문에 필수

영어: 글로벌 확장 준비

한국어랑 일본어가 어순이 비슷해서 다행이다. 영어 번역이 제일 까다롭다.

다국어를 나중에 추가하려고 했으면 진짜 고생했을 것 같다. 처음부터 넣길 잘했다.

#i18n#다국어#next-intl#국제화#일본#영어

노트 목록으로