VS Code 한글 깨짐·폰트 문제 해결법 5가지 정리

VS Code 한글 깨짐은 인코딩과 폰트 설정 몇 가지만 잡으면 대부분 해결됩니다. 새 파일을 처음 켰을 때 한글 주석이 외계어처럼 보이는 증상부터, 터미널 출력이 깨지는 경우까지 — 개발 경험이 없어도 따라 할 수 있게 메뉴 위치를 하나하나 짚어 5가지 해결법을 정리했습니다.

이 글은 개발 경험이 없어도 따라 할 수 있게 메뉴 위치를 하나하나 짚어드립니다. 핵심 키워드는 "vscode 한글 깨짐"이지만, 실제 원인은 인코딩·폰트·터미널 세 갈래라 각각 어떻게 다른지부터 짧게 짚고 시작합니다.

한글 깨짐, 원인부터 알아야 빠릅니다

VS Code 한글 깨짐은 대부분 인코딩 불일치, 폰트 미지원, 터미널 설정 누락 셋 중 하나입니다. 원인을 모르고 무작정 따라 하면 엉뚱한 설정만 바꾸다 시간을 버리거든요.

여기서 인코딩(encoding)이란 컴퓨터가 글자를 숫자로 저장하는 방식입니다. 한국어를 위한 방식은 크게 두 가지인데, 이게 어긋나면 글자가 깨져 보입니다.

인코딩	특징	주로 쓰는 곳
UTF-8	전 세계 언어를 다 담는 표준	웹, 맥, 리눅스, 최신 윈도우
EUC-KR / CP949	한국어 전용 옛날 방식	오래된 윈도우 메모장 파일, 일부 한국 사이트

같은 글자라도 둘이 저장 방식이 달라서, EUC-KR로 저장된 파일을 UTF-8로 열면 깨집니다. 반대도 마찬가지고요.

파일 저장: EUC-KR  →  열기: UTF-8  →  결과: ??ъ슜??
파일 저장: UTF-8   →  열기: UTF-8   →  결과: 사용자 ✓

이 그림 한 장만 머리에 넣어두시면 아래 해결법이 훨씬 잘 이해됩니다.

해결법 1: 파일 인코딩을 UTF-8로 다시 열기

가장 흔한 케이스는 EUC-KR 파일을 UTF-8로 잘못 열어서 깨진 경우입니다. 이때는 파일을 다시 올바른 인코딩으로 열기만 해도 글자가 정상으로 돌아옵니다.

순서는 이렇습니다.

1. VS Code 화면 오른쪽 아래에 UTF-8이라고 적힌 작은 글씨를 클릭
2. 위쪽에 뜨는 메뉴에서 "Reopen with Encoding" (인코딩으로 다시 열기) 선택
3. 목록에서 "Korean (Windows 949)" 또는 "Korean (EUC-KR)" 선택

깨졌던 글자가 한글로 돌아오면 성공입니다.

💡 한 번 잘못 저장된 파일을 그냥 UTF-8로 강제 변환하면 깨진 글자가 영구히 박힙니다. 반드시 원본 인코딩으로 먼저 연 다음, 아래 해결법 2로 변환하세요.

해결법 2: 새 파일은 무조건 UTF-8로 통일하기

앞으로 만들 파일은 처음부터 UTF-8로 통일하는 게 가장 깔끔합니다. 요즘 표준이 UTF-8이라 협업·웹 게시·AI 도구 연동까지 다 편해집니다.

설정 위치는 다음과 같습니다.

1. 윈도우/리눅스: Ctrl + , / 맥: Cmd + , (설정 창 열기 단축키)
2. 검색창에 encoding 입력
3. Files: Encoding 항목을 utf8로 변경
4. 바로 아래 Files: Auto Guess Encoding 체크박스를 켜기

두 번째 옵션을 켜두면 파일을 열 때 VS Code가 인코딩을 자동으로 추측합니다. 100%는 아니지만, EUC-KR 파일을 멋대로 UTF-8로 열어 깨뜨리는 사고를 크게 줄여줍니다.

이미 깨지지 않은 EUC-KR 파일을 UTF-8로 영구 변환하려면, 오른쪽 아래 인코딩 표시를 클릭한 뒤 "Save with Encoding" → "UTF-8"을 누르면 됩니다.

해결법 3: 한글 폰트가 못생길 때 — 폰트 바꾸기

글자가 깨진 게 아니라 한글만 어색하게 픽셀이 튀거나 영문보다 작아 보이는 경우는 폰트 문제입니다. VS Code 기본 폰트가 한글을 지원하지 않아 시스템이 임시로 다른 폰트를 끼워 넣는 거죠.

추천 폰트는 코딩용으로 만들어진 한글 친화 폰트입니다.

폰트 이름	특징	다운로드
D2Coding	네이버 제공, 한국 개발자 표준	네이버 D2 사이트 무료
나눔고딕코딩	깔끔, 가독성 좋음	네이버 나눔글꼴 무료
Sarasa Mono K	한·영 굵기 균형 우수	GitHub 오픈소스 무료

설치 후 적용 방법은 간단합니다.

1. 설정(Ctrl + ,) 열기
2. 검색창에 font family 입력
3. Editor: Font Family 칸에 아래처럼 입력

'D2Coding', 'Consolas', monospace

따옴표 안에 폰트 이름을 정확히 적고 쉼표로 여러 개를 나열하면, 앞쪽 폰트가 없을 때 뒤쪽 폰트로 자동 대체됩니다. 일종의 우선순위 목록이죠.

저는 D2Coding을 6년 넘게 쓰는데, 한글·영문·숫자·기호 폭이 일정해서 코드 정렬이 망가지지 않는 점이 제일 좋았습니다.

해결법 4: 터미널에서만 한글이 깨질 때

편집기에서는 멀쩡한데 VS Code 안의 터미널(아래쪽 검은 창, 명령어를 입력하는 영역)에서만 한글이 깨지는 경우가 있습니다. 윈도우 사용자에게 특히 자주 생깁니다.

원인은 윈도우 터미널 기본 인코딩이 옛날 방식인 CP949라서입니다. 파이썬으로 print("안녕")을 찍었는데 ?好? 같은 게 나오면 거의 이 문제입니다.

해결은 터미널 인코딩을 UTF-8로 바꿔주면 됩니다.

chcp 65001

이 명령은 현재 터미널의 코드 페이지를 UTF-8(번호 65001)로 바꿔라는 뜻입니다. VS Code 터미널을 열고 그냥 입력 후 Enter를 치면 끝입니다.

다만 이 방법은 터미널을 닫으면 풀립니다. 영구 적용하려면 설정에 다음을 추가합니다.

1. 설정 열기 → 검색창에 terminal.integrated.profiles.windows
2. Edit in settings.json 클릭
3. 열린 파일에 아래 내용 추가

"terminal.integrated.defaultProfile.windows": "Command Prompt",
"terminal.integrated.profiles.windows": {
  "Command Prompt": {
    "path": "cmd.exe",
    "args": ["/k", "chcp 65001"]
  }
}

💡 맥·리눅스 사용자는 이 단계가 필요 없습니다. 기본이 이미 UTF-8입니다.

해결법 5: 한국어 메뉴로 바꾸기 (보너스)

VS Code 메뉴가 영어로만 보여 답답하다면 한국어 언어팩을 깔면 됩니다. 한글 깨짐과는 다른 문제지만, 입문자분들이 같이 검색하는 경우가 많아 짚고 갑니다.

설치는 1분이면 끝납니다.

• [ ] 왼쪽 사이드바에서 확장(Extensions) 아이콘 클릭 (네모 4개 모양)
• [ ] 검색창에 Korean Language Pack 입력
• [ ] 마이크로소프트 공식 항목 Install 클릭
• [ ] 오른쪽 아래 Restart 버튼 누르기

재시작하면 메뉴가 모두 한국어로 바뀝니다. 다시 영어로 돌리고 싶으면 Ctrl + Shift + P를 눌러 Configure Display Language를 검색하면 됩니다.

자주 막히는 부분과 빠른 점검표

같은 증상이라도 원인이 다르면 해결법이 달라집니다. 설정 다 바꿨는데 여전히 깨진다면 아래 표로 점검해보세요.

증상	의심 원인	해결법
파일 열자마자 한글이 ???로 표시	인코딩 불일치	해결법 1
새로 저장한 파일을 다른 곳에서 열면 깨짐	저장 인코딩이 EUC-KR	해결법 2
한글만 폰트가 어색·픽셀이 튐	한글 미지원 폰트	해결법 3
print() 결과 한글만 깨짐 (윈도우)	터미널 CP949	해결법 4
메뉴가 영어로만 보임	언어팩 미설치	해결법 5

⚠️ 깨진 채로 한 번 저장 버튼을 누른 파일은 원본 글자가 사라집니다. 항상 깨짐을 먼저 해소한 뒤 저장하세요. 백업 습관도 한 번씩 떠올리시면 좋습니다.

저도 처음엔 해결법 1과 2를 헷갈려서 멀쩡한 파일을 망가뜨린 적이 있습니다. "다시 열기"와 "다시 저장하기"는 다른 동작이라는 점, 꼭 기억해두세요.

마무리

한글 깨짐은 무서워 보이지만 결국 인코딩·폰트·터미널 세 곳만 점검하면 끝납니다. 새 파일은 UTF-8로 통일하고, 한글 친화 폰트 하나 깔아두고, 윈도우라면 터미널을 UTF-8로 맞춰두기 — 이 셋만 처음에 잡아두시면 앞으로 같은 문제로 검색할 일이 거의 없습니다.

다음 단계로 VS Code의 자동 저장이나 Git 연동 설정도 함께 잡아두시면 작업 속도가 눈에 띄게 빨라집니다. 그 부분은 다음 글에서 이어가겠습니다.

(글 작성 시점 기준 VS Code 1.95 버전에서 모든 메뉴 위치를 확인했습니다. 추후 버전에서 메뉴 이름이 살짝 바뀔 수 있으니, 안 보이면 설정 검색창을 활용하시면 됩니다.)

함께 보면 좋은 글

• 맥 터미널 입문
• VS Code Tab 자동완성 안 될 때 원인과 해결법 7가지
• 윈도우에서 Claude Code WSL 설치하기, 처음부터 끝까지
• Git 입문, 비개발자를 위한 5분 개념 정리