![]()
Eclipse의 문자 인코딩 이해하기

Eclipse에서 한글이 깨지는 주된 원인은 문자 인코딩 문제입니다. 문자 인코딩은 컴퓨터가 텍스트 문자를 어떻게 저장하고 표시하는지를 결정하는 방식입니다.
한글은 여러 문자 인코딩 방식에서 다르게 처리될 수 있으며, 이로 인해 깨짐 현상이 발생할 수 있습니다.주요 문자 인코딩 방식
| 인코딩 방식 | 설명 |
|---|---|
| UTF-8 | 유니코드의 변형으로, 다국어 지원에 적합 |
| EUC-KR | 한국어 전용 인코딩 방식 |
| ISO-8859-1 | 서유럽 언어 전용 인코딩 방식 |
| Shift_JIS | 일본어 전용 인코딩 방식 |
Eclipse는 기본적으로 UTF-8 인코딩을 사용하지만, 프로젝트의 설정이나 파일 생성 시 다른 인코딩 방식을 선택할 수 있습니다. 따라서 한글을 포함한 파일을 다룰 때는 반드시 올바른 인코딩 방식을 설정해야 한글 깨짐 현상을 방지할 수 있습니다.
Eclipse의 기본 설정 변경하기

Eclipse에서 한글 깨짐을 방지하기 위해서는 먼저 기본 설정을 변경해야 합니다. 기본 인코딩을 UTF-8로 설정하는 것이 일반적인 해결책입니다.
아래는 기본 인코딩을 UTF-8로 설정하는 방법입니다.설정 방법
- Eclipse 실행: Eclipse IDE를 실행합니다.
- Preferences 열기: 상단 메뉴에서
Window>Preferences를 선택합니다. - General 선택: Preferences 창에서
General>Workspace를 클릭합니다. - Text file encoding 설정:
Text file encoding항목에서Other를 선택하고 드롭다운 메뉴에서UTF-8을 선택합니다. - 적용 및 저장:
Apply and Close버튼을 클릭하여 변경 사항을 저장합니다.
이 설정을 완료하면 새로운 파일을 생성할 때 기본적으로 UTF-8 인코딩이 적용됩니다. 그러나 기존 파일의 경우, 추가적인 설정이 필요할 수 있습니다.
기존 파일 인코딩 변경하기
| 단계 | 설명 |
|---|---|
| 1 | 프로젝트 탐색기에서 파일을 선택합니다. |
| 2 | 마우스 오른쪽 버튼을 클릭하고 Properties를 선택합니다. |
| 3 | Resource 탭에서 Text file encoding을 찾아 UTF-8로 변경합니다. |
| 4 | OK 버튼을 클릭하여 설정을 완료합니다. |
위의 단계에 따라 기존 파일의 인코딩도 UTF-8로 변경해 주셔야 합니다. 이렇게 설정하면 한글이 깨지지 않고 정상적으로 표시될 것입니다.
프로젝트별 인코딩 설정하기

Eclipse에서는 각 프로젝트마다 인코딩을 다르게 설정할 수 있습니다. 특정 프로젝트에서만 한글이 필요할 경우, 해당 프로젝트의 인코딩을 별도로 설정하는 것이 유용합니다.
다음은 프로젝트별 인코딩을 설정하는 방법입니다.설정 방법
- 프로젝트 선택: 프로젝트 탐색기에서 인코딩을 변경할 프로젝트를 선택합니다.
- Properties 열기: 선택한 프로젝트에서 마우스 오른쪽 버튼을 클릭하고
Properties를 선택합니다. - Resource 선택: 왼쪽 메뉴에서
Resource를 클릭합니다. - Text file encoding 설정:
Text file encoding항목에서Other를 선택하고 드롭다운 메뉴에서UTF-8을 선택합니다. - 적용 및 저장:
Apply버튼을 클릭하고,OK를 클릭하여 변경 사항을 저장합니다.
이렇게 설정하면 해당 프로젝트에 있는 모든 파일이 UTF-8 인코딩으로 처리되어 한글이 정상적으로 표시됩니다. 프로젝트별로 인코딩을 다르게 설정할 수 있기 때문에, 다양한 언어로 작업하는 경우 유용합니다.
Eclipse 콘솔 출력 설정
Eclipse에서 한글이 정상적으로 표시되기 위해서는 콘솔 출력 설정도 중요합니다. Eclipse의 콘솔 창에서 한글이 깨지는 경우, 콘솔의 인코딩을 변경해야 합니다.
다음은 콘솔 출력을 위한 인코딩 설정 방법입니다.설정 방법
- Eclipse 실행: Eclipse IDE를 실행합니다.
- Run Configurations 열기: 상단 메뉴에서
Run>Run Configurations...를 선택합니다. - Configuration 선택: 현재 실행 중인 프로그램의 설정을 선택합니다.
- Common 탭 선택: 오른쪽에서
Common탭을 클릭합니다. - Encoding 설정:
Encoding항목에서UTF-8을 선택합니다. - 적용 및 저장:
Apply버튼을 클릭하고,Close를 클릭하여 설정을 저장합니다.
이 설정을 완료하면 Eclipse의 콘솔에서도 한글이 정상적으로 표시됩니다. 이와 같은 설정은 프로젝트의 특성에 따라 다를 수 있으므로, 필요한 경우에 따라 조정이 필요할 수 있습니다.
마무리 및 추가 팁
Eclipse에서 한글 깨짐 현상을 방지하기 위한 설정 방법에 대해 알아보았습니다. 기본 인코딩을 UTF-8로 설정하고, 각 프로젝트별로 인코딩을 조정하며, 콘솔 출력 설정까지 신경 쓰면 한글이 깨지는 문제를 효과적으로 방지할 수 있습니다.
또한, Eclipse를 사용할 때는 다른 IDE에서도 유사한 문제가 발생할 수 있으므로, 기본적인 인코딩 개념을 알아보고 적용하는 것이 필요합니다. 마지막으로, Eclipse의 업데이트가 이루어질 때마다 설정이 초기화될 수 있으므로, 주기적으로 설정을 확인하는 것이 좋습니다.한글이 깨지지 않고 원활하게 개발 환경을 운영하실 수 있기를 바랍니다.