# 엔진 임포트 시 번역 파일 오류가 발생하는 이유
번역 테이블은 편집하기 쉽지만 포맷 오류가 발생하기 쉽습니다. 문장 안의 쉼표나 따옴표 누락은 전체 언어 열을 어긋나게 만듭니다.Godot와 Unity Localization 패키지는 엄격한 CSV 포맷을 요구합니다. 본 도구는 임포트 전 구조를 검증하고 정상화합니다.# 검사 항목
임포트 전 감지
육안으로 찾기 어려운 포맷 오류
- 미번역 빈 셀
- 중복 입력된 키
- 열 수가 맞지 않는 손상 행
- 잘못된 따옴표 구문
내보내기 시 정규화
안전한 자동 보정
- 부족한 열 패딩
- 초과 열 결합 처리
- 첫 번째 중복 키 유지
- 원본 파일 보호
# 정제된 파일 검토 방법
구조 정형이 언어적 검수를 대신하지는 않습니다. 검출 목록을 확인하여 누락된 번역을 보완하세요.| 검출 항목 | 의미 | 권장 조치 |
|---|---|---|
| 빈 셀 | 언어 열에 텍스트가 없음 | 번역을 입력하거나 의도된 빈 값인지 확인 |
| 중복 키 | 동일한 키가 여러 행에 존재 | 내용을 비교한 뒤 첫 번째 행 적용 |
| 손상된 행 | 헤더와 열 수가 불일치 | 병합된 최종 열 확인 |
| 파싱 오류 | 잘못된 JSON 구문 | 임포트 전 JSON 수정 |
# 게임 번역용 CSV 규칙
쉼표나 줄바꿈이 포함된 텍스트는 큰따옴표로 감싸야 합니다.원본 파일 보관
번역가에게 전달받은 원본 파일의 백업을 반드시 유지하세요.- 번역 키
- 게임 코드에서 식별자로 사용하는 고유 문자열.
- CSV 필드
- 구분자로 구분된 개별 값.
- 이스케이프
- 문장 부호를 텍스트로 유지하기 위한 따옴표 처리.
- 로케일
- ko, en, ja와 같은 언어 및 지역 코드.