Eclipse는 다양한 프로그래밍 언어를 지원하는 통합 개발 환경(IDE)으로, 많은 개발자들이 애용하고 있습니다. 그러나 Eclipse를 사용하면서 한글 출력 시 깨지는 문제가 발생하는 경우가 종종 있습니다.
이러한 문제는 개발 과정에서 사용자에게 큰 불편을 초래할 수 있습니다. 이번 글에서는 Eclipse에서 한글 깨짐을 방지하기 위한 환경 설정 방법에 대해 자세히 알아보겠습니다.
![]()
Eclipse 기본 설정 확인

Eclipse에서 한글이 깨지는 가장 큰 원인 중 하나는 기본 문자 인코딩 설정이 맞지 않기 때문입니다. 이 문제를 해결하기 위해서는 Eclipse의 기본 문자 인코딩을 UTF-8로 설정하는 것이 필요합니다.
아래의 표는 Eclipse 기본 설정을 확인하는 방법을 단계별로 정리한 것입니다.
| 단계 | 설명 |
|---|---|
| 1 | Eclipse를 실행합니다. |
| 2 | 메뉴에서 ‘Window’를 클릭합니다. |
| 3 | ‘Preferences’를 선택합니다. |
| 4 | ‘General’ > ‘Workspace’로 이동합니다. |
| 5 | ‘Text file encoding’ 옵션을 찾아 ‘Other’를 선택한 후 ‘UTF-8’로 설정합니다. |
| 6 | ‘Apply’를 클릭한 후 ‘OK’를 누릅니다. |
이러한 기본 설정을 통해 Eclipse의 전체적인 문자 인코딩을 UTF-8로 변경하면, 한글을 포함한 다양한 문자들이 올바르게 표시될 가능성이 높아집니다. 기본 설정 이후에도 문제가 지속된다면, 프로젝트 단위로 추가 설정이 필요할 수 있습니다.
프로젝트 단위 문자 인코딩 설정

Eclipse에서는 각 프로젝트마다 개별적으로 문자 인코딩을 설정할 수 있습니다. 기본적으로 설정한 인코딩이 모든 프로젝트에 적용되지만, 특정 프로젝트에서 다른 인코딩이 필요할 수 있습니다.
이 경우, 프로젝트 단위로 인코딩을 설정하는 방법은 다음과 같습니다. 아래의 표는 프로젝트 단위로 인코딩을 설정하는 방법을 정리한 것입니다.
| 단계 | 설명 |
|---|---|
| 1 | Eclipse에서 원하는 프로젝트를 선택합니다. |
| 2 | 오른쪽 클릭 후 ‘Properties’를 선택합니다. |
| 3 | ‘Resource’를 클릭합니다. |
| 4 | ‘Text file encoding’ 옵션에서 ‘Other’를 선택합니다. |
| 5 | 드롭다운 메뉴에서 ‘UTF-8’을 선택합니다. |
| 6 | ‘Apply’를 클릭하고 ‘OK’를 누릅니다. |
이렇게 설정을 완료하면 해당 프로젝트 내에서 한글이 올바르게 출력될 것입니다. 프로젝트별로 인코딩을 설정할 수 있는 기능은 다양한 상황에서 유용하게 사용될 수 있습니다.
예를 들어, 여러 팀원이 협업하는 프로젝트에서는 각자의 개발 환경에 맞춰 인코딩을 조정할 수 있습니다.
콘솔 출력 인코딩 설정
Eclipse의 콘솔에서 한글이 깨지는 문제는 종종 콘솔 출력 인코딩 설정과 관련이 있습니다. 기본적으로 Eclipse의 콘솔은 시스템의 기본 인코딩을 따르기 때문에, 이 부분을 조정하는 것이 필요합니다.
콘솔 출력 인코딩을 설정하는 방법에 대해서 아래의 표를 참고해 주시기 바랍니다.
| 단계 | 설명 |
|---|---|
| 1 | Eclipse를 실행합니다. |
| 2 | 메뉴에서 ‘Run’을 클릭한 후 ‘Run Configurations’를 선택합니다. |
| 3 | 왼쪽 메뉴에서 실행할 프로그램을 선택합니다. |
| 4 | ‘Common’ 탭으로 이동합니다. |
| 5 | ‘Encoding’ 옵션에서 ‘Other’를 선택한 후 ‘UTF-8’로 설정합니다. |
| 6 | ‘Apply’를 클릭한 후 ‘Close’를 누릅니다. |
이렇게 설정하면, Eclipse 콘솔에서 출력되는 한글이 올바르게 표시될 것입니다. 또한 이러한 설정은 프로그램 실행 시 커맨드 라인 인코딩과 일치하도록 조정할 수 있어, 다양한 환경에서도 호환성을 유지하는 데 큰 도움이 됩니다.
한글 파일 저장 및 읽기
Eclipse에서 한글 파일을 저장하거나 읽을 때도 인코딩 설정이 영향을 줍니다. 파일을 저장할 때 인코딩이 맞지 않으면, 한글이 깨져 저장될 수 있습니다.
따라서 파일을 저장할 때도 인코딩을 확인하는 것이 필요합니다. 아래의 표는 파일 저장 시 인코딩을 확인하는 방법을 정리한 것입니다.
| 단계 | 설명 |
|---|---|
| 1 | 파일을 저장할 때 ‘File’ 메뉴를 클릭합니다. |
| 2 | ‘Save As’를 선택합니다. |
| 3 | ‘Encoding’ 옵션에서 ‘UTF-8’을 선택합니다. |
| 4 | ‘Save’ 버튼을 클릭하여 파일을 저장합니다. |
이처럼 저장할 때 인코딩을 명시적으로 설정하면, 한글이 포함된 파일이 깨지지 않고 올바르게 저장될 수 있습니다. 또한 Eclipse에서 파일을 열 때도 인코딩 옵션을 확인하는 것이 좋습니다.
파일을 열 때 인코딩을 잘못 설정하면, 이미 저장된 한글 파일이 깨져 보일 수 있습니다.
한글 깨짐 문제 해결을 위한 추가 팁
Eclipse에서의 한글 깨짐 문제는 여러 가지 원인으로 발생할 수 있습니다. 따라서 이러한 문제를 해결하기 위한 몇 가지 추가 팁을 제공해 드리겠습니다.
아래의 표는 한글 깨짐 문제를 예방하고 해결하는 데 도움이 될 수 있는 방법을 정리한 것입니다.
| 팁 | 설명 |
|---|---|
| 1 | Eclipse 최신 버전 사용: 최신 버전에서는 다양한 버그가 수정되어 있을 수 있습니다. |
| 2 | JDK 인코딩 확인: JDK의 기본 인코딩이 UTF-8인지 확인합니다. |
| 3 | 파일 인코딩 변환: 기존 파일의 인코딩을 UTF-8로 변환하여 저장합니다. |
| 4 | 프로젝트 설정 검토: 프로젝트 단위로 인코딩 설정이 올바르게 되어 있는지 확인합니다. |
| 5 | 플러그인 사용: 한글 지원을 향상시키기 위한 플러그인을 설치해 사용할 수 있습니다. |
이러한 팁들을 통해 Eclipse에서의 한글 깨짐 문제를 예방하고, 보다 원활한 개발 환경을 유지할 수 있을 것입니다. 개발자들이 자주 겪는 문제인 만큼, 이러한 설정을 통해 불필요한 시간을 절약하고 더 나은 개발 경험을 누릴 수 있기를 바랍니다.
결론
Eclipse에서 한글 깨짐 문제는 기본적인 인코딩 설정을 통해 쉽게 해결할 수 있습니다. 기본 설정뿐만 아니라 프로젝트 단위, 콘솔 출력, 파일 저장 및 읽기 등 다양한 부분에서 인코딩을 확인하고 조정하는 것이 필요합니다.
이러한 세심한 설정이 개발 과정에서의 불편을 줄여줄 것입니다. 개발자 여러분이 Eclipse에서 한글을 자유롭게 사용할 수 있도록 환경을 설정하시길 바랍니다.