링고 정리

원본 메시지가 더 이상 사용되지 않는지 확인한 뒤 불필요해진 JSONC 카탈로그 항목을 삭제합니다.

소스 코드에서 메시지가 제거되면 추출 과정에서 해당 카탈로그 항목을 고아 항목으로 표시합니다. lingo clean는 이러한 원본 항목과 현재 사용 중인 원본 집합에 더 이상 없는 대상 키를 삭제합니다. 로캘 파일 전체가 아닌 개별 항목만 수정하며, 누락된 값을 번역하지는 않습니다.

먼저 삭제해도 되는지 확인하세요 #

추출을 실행한 뒤 경고와 고아 항목을 확인하세요. 동적 호출이나 구조 분해된 호출은 애플리케이션에서 여전히 사용 중이어도 추출 과정에서 더 이상 인식되지 않을 수 있습니다. 필요한 메시지를 삭제하는 대신 추출 문제를 해결하세요.

정리하기 전에 복구할 수 있도록 변경 내역을 보관하세요. 이 명령은 원본과 검색된 모든 대상 JSONC 카탈로그를 즉시 다시 씁니다. 모의 실행, 확인 플래그, 대상 로캘 필터는 제공하지 않습니다.

sh
lingo clean --source-locale en

--source-locale의 기본값은 en입니다. --out를 지정하면 설정된 i18n.messagesPath, 그다음 locales보다 우선 적용되며, 경로는 프로젝트 루트를 기준으로 합니다. 원본 <locale>.jsonc는 반드시 존재하고 비어 있지 않아야 합니다. 그렇지 않으면 명령이 실패하고 추출을 먼저 실행하라는 안내가 표시됩니다.

카탈로그 유지 관리를 마무리하세요 #

실행 결과에 표시된 원본 및 대상별 삭제 개수를 확인한 뒤 변경 내역을 살펴보세요. 정리 명령은 타입스크립트 선언을 다시 생성하지 않습니다. 동일한 경로와 원본 로캘로 추출과 검사를 실행한 다음, 애플리케이션의 검사도 실행하세요.

대상 파일이나 기준 데이터를 의도적으로 삭제하려면 완전 삭제를 사용하세요. 고아 카탈로그 항목을 삭제하려면 clean를 사용하세요.