[IntelliJ] .properties 한글 깨짐 해결 (Encoding)

joyful·2026년 1월 15일

기타

목록 보기
7/7

❌ 문제 상황

Spring Boot 프로젝트에서 messages.properties를 활용해 메시지 관리 기능을 테스트하던 중, 실행 화면에서 한글이 정상적으로 출력되지 않고 "?? ???"와 같이 깨져서 보이는 현상이 발생했다.


✅ 해결 방법

IntelliJ 설정에서 .properties 파일의 인코딩 방식을 UTF-8로 변경하고, 이를 자동으로 변환해주는 옵션을 활성화해야 한다.

  1. 설정(Windows: Ctrl + Alt + S / macOS: Cmd + ,) 창을 연다.
  2. 에디터 > 파일 인코딩 메뉴로 이동한다.
  3. 하단의 프로퍼티 파일 섹션을 다음과 같이 설정한다.
    • 프로퍼티 파일에 대한 디폴트 인코딩: UTF-8로 변경
    • 명확한 Native에서 ASCII로의 변환: 체크박스 선택
  4. 적용확인을 눌러 설정을 저장한다.

💡 주의사항

설정을 바꾸기 전에 이미 작성된 한글은 인코딩 변경 후에도 깨져 보일 수 있다.

이 경우, 해당 텍스트를 지우고 다시 한글로 입력한 뒤 저장하면 정상적으로 출력된다.

profile
기쁘게 코딩하고 싶은 백엔드 개발자

0개의 댓글