tech.inflab.com · 2025. 02. 07.
기존 서비스 국제화(i18n) 작업 쉽게 덜어내기: t 함수 자동 래핑 스크립트 만들기
AI 엔지니어링 브리핑
기존 한국어 화면을 다국어 서비스로 빠르게 바꾸기 위해 번역 함수 적용과 번역 자료 생성을 자동화한 방법을 소개합니다.
문제 & 배경
- 문제 & 배경: 글로벌 서비스 출시를 앞두고 기존 코드 곳곳의 한국어를 일일이 번역 함수로 감싸고 언어 파일을 만드는 작업이 너무 많아 생산성이 떨어질 수 있었습니다.
기술 & 해결책
- 기술 & 해결책: Babel의 AST 분석 기능으로 코드 속 한국어를 찾아
t()로 자동 변환하고, React 훅 규칙에 맞춰useTranslation과 import를 추가했으며, 별도의 추출기가 번역 대상 문구를 JSON 언어 파일로 생성하도록 했습니다.
교훈 & 주의점
- 교훈 & 주의점: 한글을 번역 키로 사용하면 빠르고 직관적으로 작업할 수 있지만 원문 변경과 문맥별 중복에 주의해야 하며, 실제 적용 전에는 파일별 제외 경로와 템플릿 문자열 같은 동적 문구 처리를 설정하고 검토해야 합니다.
함께 읽을 글
내용이 비슷해요내용이 비슷한 글을 먼저 보여드려요. 같은 문제나 해결책을 다룬다는 뜻은 아니에요.