배포 전 i18n 키 누락을 실시간 감지하는 VS Code 확장 도구

Context

다국어 서비스 운영 중 i18n 키 누락으로 인한 UI 버그 빈번 발생. 수동 검토 방식의 낮은 효율성과 휴먼 에러 가능성 상존. 리팩토링 과정에서 발생하는 localization 참조 깨짐 현상 방지 필요.

Technical Solution

• 프로젝트 전반의 i18n 키 참조 상태를 실시간 분석하는 스캐닝 로직 구현
• 정의되지 않은 translation key 사용 시 에디터 내 즉각적인 경고 표시
• UI 컴포넌트 내 하드코딩된 번역되지 않은 문자열 자동 탐색
• JSON 기반 번역 파일과 소스 코드 간의 키 일치 여부를 검증하는 매핑 알고리즘 적용
• React, Vue, Next.js 등 다양한 프론트엔드 프레임워크 호환 설계

Key Takeaway

반복적인 수동 검증 프로세스를 개발 도구 수준의 자동화로 전환하여 런타임 에러를 컴파일 타임 혹은 작성 단계에서 예방하는 시프트 레프트(Shift-left) 전략의 중요성.