VS Code에서 한글 주석이 깨졌을 때 복구 방법

가든_ 2025. 1. 30. 20:39

Rider 무료 사용 기간이 끝나서 VSCode로 넘어갔는데, 작성한 한글 주석이 모두 깨져 있었다.
이런 문제는 보통 인코딩 설정 때문에 발생하는데, 해당 설정만 바꿔주면 해결된다.

[원인]

인코딩이란?

인코딩은 간단히 말해, 텍스트 데이터를 컴퓨터가 이해할 수 있도록 변환하는 방법이다. 컴퓨터는 텍스트 자체를 직접적으로 처리할 수 없기 때문에, 각 문자를 숫자 코드로 변환해 저장한다. 이때 사용하는 규칙이 바로 문자 인코딩이다.

대표적인 인코딩 방식으로는 UTF-8, EUC-KR, Shift-JIS 등이 있다. 예를 들어, 'A'라는 문자는 UTF-8에서는 65로, EUC-KR에서는 0xC1로 인코딩된다. 각각의 인코딩 방식은 다르게 문자를 표현하는 방식이기 때문에, 같은 문자가 다른 방식으로 저장될 수 있다.

한글 주석이 깨지는 이유

한글 주석이 깨지는 이유는 인코딩 방식의 불일치 때문이다. 예를 들어, 한글을 EUC-KR 인코딩으로 저장한 파일을 UTF-8 인코딩을 사용하는 프로그램에서 열면, 프로그램은 저장된 데이터를 잘못 해석하게 된다. 이 경우, 문자들이 깨지거나 알아볼 수 없는 기호로 표시된다.

이처럼 파일을 작성할 때 사용한 인코딩 방식과, 파일을 열 때 사용한 인코딩 방식이 달라지면, 컴퓨터가 텍스트를 정확하게 이해하지 못해 깨지는 현상이 발생한다. 이는 주로 다른 운영체제나 다른 개발 툴을 사용할 때 자주 발생한다. 예를 들어, 한글을 주로 사용하는 한국에서는 EUC-KR 또는 CP949 인코딩을 많이 사용하지만, UTF-8을 기본 인코딩으로 사용하는 다른 환경에서 파일을 열면 이와 같은 문제가 생긴다.

[해결방법]

1. 파일 인코딩 확인 및 변경하기

VSCode에서 깨진 파일을 연다.
오른쪽 아래 상태 표시줄에서 인코딩(UTF-8일 가능성이 높음) 을 클릭한다.

Reopen with Encoding → UTF-8을 선택한다.

그래도 안 되면 Reopen with Encoding → EUC-KR도 시도해 본다.

2. 기본 인코딩 변경하기

VSCode에서 Ctrl+Shift+P를 눌러 Settings: Open Settings (JSON)을 선택한다.

아래와 같이 추가하여 기본 인코딩을 UTF-8로 설정

"files.encoding": "utf8"

왜 UTF-8을 기본으로 사용할까?

UTF-8은 유니코드를 기반으로 한 인코딩 방식으로, 거의 모든 문자를 표현할 수 있다는 장점이 있다. 이는 전 세계 모든 언어를 지원하기 때문에, 다양한 언어를 사용하는 개발 환경에서 널리 사용된다. 그래서 최신 개발 도구나 운영체제에서는 UTF-8을 기본 인코딩으로 채택하는 경우가 많다.
하지만 한국에서는 여전히 EUC-KR 또는 CP949와 같은 인코딩을 사용한 파일이 많기 때문에, 이를 다룰 때 인코딩 불일치 문제를 겪을 수 있다. 특히, 구형 시스템이나 특정 환경에서 EUC-KR로 저장된 파일이 많기 때문에, 이를 처리할 때는 해당 인코딩 방식에 맞춰 설정을 변경해주어야 한다.