피드로 돌아가기
Dev.toDevOps
원문 읽기
CI 파이프라인 통합을 통한 Locale Drift 및 런타임 인터폴레이션 오류 제로화
Your locale files are drifting behind English and nobody reviews it
AI 요약
Context
다국어 지원 서비스에서 English 소스 파일과 타 언어 파일 간의 키 불일치(Locale Drift) 발생. 수동 보정 과정에서 Placeholders 파손 및 HTML 태그 누락으로 인한 런타임 Exception 발생 빈도 증가.
Technical Solution
- GitHub App 기반의 자동화 워크플로우를 통해 PR 단위의 실시간 Locale 동기화 구현
- Source Locale(English) 분석을 통한 타 언어 파일 내 Missing Keys 정밀 식별
- LLM 기반 번역 시 Placeholder 및 Inline HTML 구조를 보존하는 제약 조건 적용
- 자동 Commit 및 PR Comment 기능을 통한 리뷰 프로세스 내 번역 검증 단계 제거
- Flat 및 Nested JSON 구조를 모두 지원하는 유연한 디렉토리 매핑 설계
- .i18n-autopilot.json 설정을 통한 프로젝트별 Source Locale 및 폴더 경로 커스텀 가능
실천 포인트
1. i18n 키 추가 시 CI 단계에서 자동 검증 및 보정 프로세스가 구축되었는지 확인
2. LLM 번역 적용 시 {name}, {{count}} 등 인터폴레이션 토큰의 무결성 보장 전략 수립
3. 다국어 파일의 Drift를 방지하기 위해 소스 언어 기준의 자동 동기화 파이프라인 검토