유니티 Rider에서 한글 주석 깨짐(잘못된 인코딩) 문제 해결하기

개요

Unity 프로젝트에서 한글 주석을 작성하다 보면, 가끔 Rider 편집기 상단에

“The file was loaded in a wrong encoding: ‘UTF-8’”
라는 빨간 에러 바가 뜨며 Ä¥ÆÇ¿¡… 같은 깨진 글자가 보일 때가 있습니다.
이 글에서는 Rider에서 파일 인코딩을 바로 잡고, 한글 주석을 정상적으로 표시하는 방법을 단계별로 정리합니다.

“The file was loaded in a wrong encoding: ‘UTF-8’”

---

원인

파일이 실제로는 CP949(윈도우 한글) · EUC-KR 등으로 저장되어 있는데, Rider가 UTF-8으로 불러오면서 바이트를 잘못 해석해 깨진 글자가 나옵니다.

---

해결 방법

“Reload in another encoding” 클릭 / x- Windows-949 선택

1. “Reload in another encoding” 클릭

1. 에디터 상단 빨간 바 우측의 Reload in another encoding 버튼을 클릭
2. 팝업에서 Korean (Windows-949) 혹은 EUC-KR 선택
3. Reload → 한글 주석이 바로 보이는지 확인

대부분 이 단계만으로도 깨짐 현상이 사라집니다.

에러 해결!

---

2. (선택) 파일을 UTF-8로 변환

파일을 앞으로 UTF-8로 관리하고 싶다면:

1. 파일 탭 우클릭 → File Encoding → Convert to UTF-8
2. 저장 후 다시 열면, 인코딩 문제 없이 UTF-8로 유지됩니다.

---

3. Rider 프로젝트 기본 인코딩 설정

1. File → Settings… (Ctrl+Alt+S / macOS ⌘ ,)
2. 좌측 Editor → File Encodings 선택
3. 우측에서
   • Global Encoding → UTF-8
   • Project Encoding → UTF-8
   • Default encoding for properties files → UTF-8
4. Apply → OK → Rider 재시작

---

정리

1. 잘못된 인코딩 경고가 뜨면 → “Reload in another encoding” → Windows-949 선택
2. 이후 필요 시 → Convert to UTF-8
3. 프로젝트 전체 설정 → Global/Project Encoding을 UTF-8으로 고정

이 세 가지만 기억하시면, Rider에서 한글 주석이 깨지지 않고 깔끔하게 표시됩니다.

 

도움이 되셨다면 댓글과 공감 부탁드려요!