VS Code 최신 업데이트 후 터미널 한글 깨짐 해결하기

 

"어제까지 잘 되던 VS Code, 업데이트했더니 터미널이 외계어로 도배됐어요!" 최신 업데이트 직후 발생하는 골치 아픈 터미널 한글 깨짐 현상과 익스텐션(확장 프로그램) 충돌 및 무한 로딩 문제를 3분 만에 깔끔하게 해결하는 방법을 알려드립니다!

 

아침에 커피 한 잔 마시고 상쾌한 기분으로 코딩을 시작하려는데, 무심코 누른 VS Code(Visual Studio Code) 업데이트 버튼 하나에 모든 평화가 깨진 적 있으신가요? 코드를 수정하고 터미널에 빌드 명령어를 쳤는데 결과 창에 '뛠뛣', '????' 같은 알 수 없는 외계어가 쏟아지면 정말 눈앞이 깜깜해지죠.

게다가 평소에 찰떡같이 작동하던 코드 자동 정렬(Prettier)이나 문법 검사기(ESLint)마저 먹통이 되면서 빨간 줄이 마구잡이로 그어지면 진짜 완전 짜증이 솟구칩니다. 저도 얼마 전 대규모 업데이트 직후에 이 두 가지 문제를 동시에 겪고 아침 시간을 통째로 날려먹은 쓰라린 기억이 있어요. 하지만 걱정 마세요! 제 경험상 이 문제들은 프로그램이 고장 난 게 아니라 설정값(Settings)이 초기화되거나 버전 충돌이 일어난 단순한 해프닝일 확률이 높습니다. 오늘 제가 직접 해결했던 방법들을 알기 쉽게 정리해 드릴 테니, 스트레스받지 말고 천천히 따라와 보세요! 😊

 

현대적이고 하이테크한 작업 공간을 보여주는 isometric 3D 일러스트레이션입니다. 밝게 빛나는 컴퓨터 모니터에는 VS Code가 실행 중이며, 화면 위에 투명한 청록색 톱니바퀴 아이콘이 부유하며 수리를 상징하고 있습니다. 모니터 하단의 터미널 창은 위쪽의 깨지고 글리치된 외계 문자에서 아래쪽의 깨끗하고 가독성 있는 'Workspace settings restored' 코드로 복구되고 있습니다. 책상 위에는 키보드, 마우스, 'DEV FUEL' 머그컵, 다육 식물, 스마트폰이 놓여 있으며, 창밖으로 도시 야경이 보입니다. 부드러운 청록색과 회색 팔레트가 사용되었습니다.

1. 터미널 한글 깨짐, 왜 갑자기 생기는 걸까? 🤔

해결책을 적용하기 전에 왜 이런 일이 벌어졌는지 짚고 넘어가 볼까요? 주로 윈도우(Windows) 환경에서 자주 발생하는 이 문제는 '인코딩(Encoding) 방식의 차이'와 '폰트(Font) 미지원' 때문에 발생합니다.

윈도우 기본 터미널(CMD, PowerShell)은 한글을 표현할 때 전통적인 EUC-KR (CP949) 방식을 선호하는 반면, 요즘 개발 환경은 전 세계 표준인 UTF-8을 기준으로 돌아갑니다. 업데이트 과정에서 VS Code 터미널의 기본 인코딩 설정이 꼬이거나, 터미널 폰트가 한글을 지원하지 않는 폰트(예: Consolas 기본형)로 초기화되면서 글자가 깨져 보이게 되는 것이죠.

💡 알아두세요!
터미널에 한글이 깨진다고 해서 내 소스 코드 자체가 망가진 것은 절대 아닙니다! 단지 화면에 '보여주는 방식(출력)'이 엉킨 것뿐이니 안심하셔도 됩니다.

 

2. 터미널 한글 깨짐 3분 해결법 🛠️

자, 이제 직접 고쳐볼까요? 크게 두 가지 설정을 손봐야 합니다. settings.json 파일을 열어서 아래 과정을 순서대로 진행해 주세요. (단축키 Ctrl + , 를 누르고 우측 상단의 파일 모양 아이콘을 클릭하면 열립니다.)

해결 단계 적용해야 할 설정 및 내용
Step 1. 폰트 변경 "terminal.integrated.fontFamily": "'D2Coding', Consolas"
터미널 폰트를 한글 지원 개발자 폰트(D2Coding이나 맑은 고딕 등)로 최우선 설정합니다.
Step 2. 인코딩 강제 고정 (Windows) "terminal.integrated.profiles.windows" 옵션 내부에 PowerShell 실행 인자로 -NoExit", "-Command", "chcp 65001"을 추가해 터미널 시작 시 항상 UTF-8로 실행되게 만듭니다.

코드를 직접 수정하기 번거로우신 분들을 위해, 복사해서 바로 붙여넣을 수 있는 설정 코드 생성기를 준비했습니다. 본인의 환경을 입력해 보세요!

🔧 settings.json 자동 복구 코드 생성기

⚠️ 주의하세요!
settings.json 파일은 쉼표(,) 하나만 빠져도 전체 설정에 에러가 생깁니다. 기존에 작성된 코드의 맨 마지막 줄이라면 쉼표를 빼주시고, 중간에 끼워 넣는다면 윗줄과 아랫줄 사이의 쉼표 여부를 꼭 확인하세요.

 

3. 익스텐션(Extension) 충돌 및 무한 로딩 해결법 💡

터미널을 고쳤는데 이번엔 자동 완성이나 문법 검사가 안 되나요? 업데이트 이후 VS Code 코어 버전과 기존에 깔아둔 확장 프로그램(Prettier, ESLint, Python 등)의 호환성이 어긋났기 때문입니다. 이럴 때는 버전을 내리거나 문제가 되는 익스텐션을 색출해야 합니다.

[가장 확실한 대처법 2가지 📝]

1. 특정 익스텐션 롤백(다운그레이드):
좌측 익스텐션 탭을 열고 문제가 되는 확장 프로그램의 톱니바퀴를 누릅니다. Install Another Version... (다른 버전 설치)을 클릭하여 방금 업데이트되기 전 버전(보통 한 달 전 버전)으로 되돌립니다. 재시작하면 거짓말처럼 잘 작동합니다.

2. 확장 이분 탐색(Extension Bisect) 활용:
도대체 어떤 익스텐션이 충돌을 일으키는지 모르겠다면, Ctrl + Shift + P를 누르고 Help: Start Extension Bisect를 실행하세요. VS Code가 익스텐션을 절반씩 껐다 켰다 하면서 범인을 자동으로 찾아주는 엄청난 기능입니다!

제 생각엔 무작정 최신 버전을 쫓기보다는 안정성이 검증된 버전을 유지하는 것도 스트레스를 줄이는 하나의 좋은 습관인 것 같습니다. 특히 회사 업무용 PC라면 자동 업데이트 옵션을 잠시 꺼두는 것도 고려해 볼 만하죠.

핵심 내용 요약 📝

오늘 다룬 VS Code 업데이트 후유증 해결 방법을 한눈에 쏙 들어오게 정리해 드립니다.

💻

VS Code 에러 대처 요약 카드

1. 원인: 업데이트 시 터미널 폰트 초기화, 인코딩 불일치, 익스텐션 호환성 오류.
2. 터미널 폰트 고정: settings.json에 한글 폰트를 최우선으로 지정합니다.
3. 인코딩 강제 고정:
PowerShell args: ["-Command", "chcp 65001"]
시작 시 항상 UTF-8 형식으로 켜지도록 강제합니다.
4. 충돌 해결: 무한 로딩 발생 시 Install Another Version을 통해 이전 버전으로 롤백합니다.
이 카드 내용만 기억하면 앞으로의 업데이트도 두렵지 않아요!

 

자주 묻는 질문 ❓

Q: D2Coding 폰트를 설치했는데도 여전히 한글이 깨져요.
A: 폰트를 윈도우에 설치한 후 VS Code를 완전히 껐다가 다시 실행해야 적용됩니다. 또한 settings.json에 입력할 때 폰트 이름을 'D2Coding'과 같이 작은따옴표로 정확히 감쌌는지 확인해 보세요.
Q: 터미널 한글은 고쳤는데, 에디터 본문의 한글 파일이 깨집니다.
A: 그건 터미널 문제가 아니라 파일 자체의 인코딩 문제입니다. 우측 하단의 인코딩 표시(EUC-KR 등)를 클릭한 뒤, '인코딩하여 다시 열기(Reopen with Encoding)'를 선택하고 'Korean (EUC-KR)' 또는 'UTF-8'을 선택해 정상으로 보일 때 저장해 주시면 됩니다.
Q: 자동 업데이트를 아예 끄고 싶은데 방법이 있나요?
A: 네, 가능합니다. 설정에서 Update: Mode를 검색한 후 값을 default에서 none으로 변경하시면 백그라운드 자동 업데이트가 중지됩니다. 안정적인 환경이 중요하다면 권장하는 방법입니다.

코딩하기도 바쁜데 에디터 설정 때문에 씨름하고 있으면 정말 진이 빠지죠. 오늘 알려드린 방법으로 쾌적한 개발 환경을 훌훌 털고 다시 되찾으셨길 바랍니다! 이 외에도 VS Code를 쓰시면서 불편했던 점이나 해결 안 되는 에러가 있다면 언제든지 댓글로 물어봐주세요~ 😊

위치: 대한민국 서울특별시