Vscode 한글 깨짐 현상 때문에 코딩 중 당황하신 적 있나요? Visual Studio Code(Vscode)를 사용할 때 한글 깨짐은 흔한 문제예요. 파일 인코딩 설정을 통해 언어셋을 변경하면 쉽게 해결할 수 있어요. 이번 글에서 Vscode 한글 깨짐 해결 방법을 단계별로 알려드릴게요!
Vscode 한글 깨짐 현상의 원인은?
Vscode 한글 깨짐은 주로 파일의 인코딩 방식이 맞지 않을 때 발생해요. 인코딩은 텍스트 데이터를 컴퓨터가 이해하도록 변환하는 방식이에요. 이 방식이 달라지면 한글이 깨지거나 이상한 기호로 보이죠.

개발자들이 자주 쓰는 인코딩 방식은 아래와 같아요.
- UTF-8: 전 세계적으로 가장 많이 쓰이는 인코딩 방식. 한글 포함 대부분 언어를 표현 가능.
- EUC-KR: 과거 한국에서 주로 사용. 한글 표현에 특화됨. 범용성은 낮음.
- ANSI: 초창기 인코딩 방식. 한글 표현에 부적합. 깨짐 현상 빈번.
한글 깨짐 문제는 파일이 ANSI로 저장되었거나, Vscode가 잘못된 인코딩 방식을 적용했을 때 주로 발생해요.
예전 웹사이트는 EUC-KR로 작업된 경우가 많아요. Html 파일을 열었을 때 콘텐츠나 주석의 한글이 깨질 수 있죠.
Vscode 한글 깨짐 해결 방법
Vscode 한글 깨짐 문제를 해결하려면 파일 인코딩 설정을 변경해야 해요. 단계별로 쉽게 따라 할 수 있도록 설명할게요.
1. 현재 파일 인코딩 확인
- Vscode에서 한글이 깨진 파일을 열어요.
- 화면 오른쪽 하단 상태 표시줄을 확인해요. 현재 파일의 인코딩 방식이 표시돼요.
- 인코딩이
UTF-8
이 아니면 문제가 생길 가능성이 높아요.

2. 올바른 인코딩으로 변경하기
- 상태 표시줄의 인코딩 정보를 클릭해요.
- “Reopen with Encoding” 옵션을 선택해요.
- 목록에서
UTF-8
또는 적절한 인코딩 방식을 선택해요. - 파일 내용이 정상적으로 표시되는지 확인해요.


3. 파일 저장 시 인코딩 설정
인코딩을 변경했는데도 한글이 깨질 수 있어요. 잘못된 인코딩으로 저장되었기 때문이에요.
- Vscode 메뉴에서 File > Preferences > Settings를 선택해요.
- 검색창에 “Save with Encoding“을 입력해요.
- Files: Encoding 항목에서
UTF-8
을 선택하고 저장해요. - 파일을 다시 열어 한글이 정상적으로 표시되는지 확인해요.

Vscode 기본 인코딩 설정 변경
매번 인코딩을 설정하는 건 번거로워요. Vscode 기본 인코딩 방식을 변경하면 편리해요.
1. 설정 변경 방법
- Vscode 메뉴에서 File > Preferences > Settings를 선택해요.
- 검색창에 “files.encoding”을 입력해요.
- 기본 인코딩을
UTF-8
로 설정해요.

2. 설정 파일 수정 방법
- 설정 화면 하단의 Edit in settings.json 버튼을 클릭해요.
- 아래 코드를 추가하거나 수정해요:
"files.encoding": "utf8"
- 저장 후 Vscode를 재시작하면 새 파일이 UTF-8로 저장돼요.
참고사항
- 다양한 인코딩 환경: 협업 프로젝트에서 EUC-KR과 UTF-8이 혼재될 수 있어요. 프로젝트 파일 인코딩을 통일하는 게 좋아요.
- 플러그인 활용: “Encoding Detector” 같은 Vscode 확장 프로그램으로 인코딩을 자동 감지할 수 있어요.
- 백업 권장: 인코딩 변경 전 원본 파일 백업을 권장해요. 잘못된 설정으로 파일이 손상될 수 있어요.
- FTP 원격 코딩 동기화: FTP로 파일 저장 시 인코딩 방식이 달라 한글이 깨질 수 있어요. 자세한 내용은 Vscode 공식 문서에서 확인하세요.
이상으로 Vscode 한글 깨짐 현상 해결 방법과 파일 인코딩 설정에 대해 알아봤어요. 더 많은 코딩 팁은 테크 가이드에서 확인하세요!
당신은 Vscode 한글 깨짐 문제를 어떻게 해결했나요? 댓글로 의견을 남겨주세요!