Cursor 한글 입력 오류와 한글 깨짐, 이렇게 해결하세요

핵심 요약: Cursor에서 한글 관련 문제는 두 종류입니다. 하나는 입력 문제(마지막 글자가 중복되거나 씹히는 현상)로, VS Code 계열 에디터의 오래된 IME 이슈이며 한국어 언어팩 확장 제거와 설정 조정으로 해결됩니다. 다른 하나는 AI 생성 코드의 한글 깨짐(주석·문자열의 유니코드 손상)으로, 파일 인코딩을 UTF-8로 고정하고 Rules에 한글 점검 지시를 추가하면 예방할 수 있습니다.

이 글에서 다루는 내용: 한글 마지막 글자 중복 현상의 원인과 해결, 한글 씹힘 완화 설정, AI가 생성한 코드의 한글 깨짐 예방법.

문제 1: 한글 마지막 글자가 두 번 입력돼요

"로그인"을 입력하고 다른 곳을 클릭하면 "로그인인"이 되는 현상입니다. VS Code 시절부터 이어져 온 한글 IME(입력기) 조합 처리 이슈로, Cursor도 VS Code 포크라서 같은 증상이 나타날 수 있습니다.

해결 순서

첫째, Korean Language Pack 확장을 제거해보세요. 이 언어팩이 원인인 사례가 가장 많이 보고됩니다. 에디터 UI가 영어로 바뀌는 것 외에 기능 차이는 없습니다. 둘째, 확장을 하나씩 비활성화하며 원인 확장을 찾아보세요. 입력 이벤트에 개입하는 확장(자동완성 계열, Vim 등)이 후보입니다. 셋째, OS 입력기를 바꿔보세요. macOS라면 기본 한글 입력기 대신 구름 입력기 등으로 바꾸면 해결되는 사례가 있고, Windows는 Microsoft 구 한글 IME 옵션 전환이 유효한 경우가 있습니다.

문제 2: 한글 타이핑이 씹히거나 커서 옆에 낱글자가 떠요

빠르게 타이핑할 때 글자가 누락되거나 조합 중인 글자가 어색하게 표시되는 현상입니다. 완화 방법 두 가지가 알려져 있습니다.

설정(settings.json)에 다음을 추가해보세요:

"editor.quickSuggestions": false 로 조합 중 제안 개입 줄이기
"editor.fontFamily": "D2Coding, monospace" 처럼 한글 지원 폰트로 변경

quickSuggestions를 끄면 일반 자동완성 팝업이 줄어드는 대신 한글 조합이 안정됩니다. 주석이나 문서를 한글로 길게 쓸 때만 임시로 꺼도 됩니다. Cursor의 Tab AI 자동완성과는 별개 설정이라 Tab은 계속 동작합니다.

문제 3: AI가 생성한 코드의 한글이 깨져요

Agent나 챗이 만든 코드에서 한글 주석·문자열이 유니코드 깨짐(�, ??)으로 나오는 경우입니다. 예방책은 두 겹으로 거는 것이 확실합니다.

먼저 파일 인코딩을 UTF-8로 고정합니다. settings.json에 "files.encoding": "utf8"을 설정하세요. 특히 Windows에서 EUC-KR로 저장된 레거시 파일을 다룰 때 이 설정이 없으면 AI 수정 과정에서 깨질 수 있습니다. 그리고 Rules에 점검 지시를 추가합니다. 프로젝트 규칙 파일(.cursor/rules)에 "코드 생성 후 한글 주석·문자열이 깨졌는지 확인하고 깨졌으면 수정할 것"을 추가하면 Composer/Agent가 생성 마지막에 스스로 점검합니다. 커뮤니티에서 검증된 방법입니다.

직접 겪은 사례

저는 마지막 글자 중복 현상을 Django 템플릿에 한글 문구를 넣다가 처음 겪었는데, 언어팩 제거로 바로 해결됐습니다. UI가 영어가 되는 게 잠깐 어색했지만 개발 용어는 어차피 영어라 일주일이면 익숙해졌습니다. 한글 깨짐 쪽은 Windows에서 받은 EUC-KR 레거시 파일을 Agent에게 수정시켰다가 주석이 전부 깨진 적이 있어서, 그 뒤로 files.encoding 고정 + Rules 점검 지시를 모든 프로젝트에 기본으로 넣고 있습니다. 이후로는 재발이 없습니다.

자주 묻는 질문 (FAQ)

Q. 언어팩을 지우면 Cursor를 한글로 못 쓰나요?

A. 에디터 메뉴가 영어로 표시될 뿐, 한글 입력·표시·AI의 한국어 응답에는 아무 영향이 없습니다. AI 응답 한국어 설정은 User Rules로 별도 지정합니다.

Q. 이 문제는 Cursor 잘못인가요?

A. 정확히는 VS Code 계열 공통의 IME 처리 이슈입니다. VS Code에서도 같은 증상이 보고되어 있으며, Cursor가 포크이기 때문에 물려받은 것입니다.

Q. quickSuggestions를 끄면 AI 자동완성도 꺼지나요?

A. 아닙니다. 이 설정은 일반 텍스트 제안 팝업에 대한 것이고, Cursor의 Tab AI 자동완성은 별개로 동작합니다.

Q. 이미 깨진 한글 주석은 복구할 수 있나요?

A. 깨진 채 저장(덮어쓰기)됐다면 복구가 어렵습니다. Git을 쓰고 있다면 이전 커밋에서 파일을 되돌리는 것이 가장 확실합니다.

한눈에 보는 요약

입력 문제는 언어팩 제거 → 확장 점검 → 입력기 변경 순서로, 씹힘은 quickSuggestions와 폰트 설정으로, AI 생성 코드의 한글 깨짐은 UTF-8 고정 + Rules 점검 지시로 해결합니다. 세 가지 모두 한 번 설정해두면 재발하지 않는 유형의 문제입니다.

함께 보면 좋은 글

Cursor 설치 및 초기 설정 (한국어 응답 설정 포함)
Cursor가 느려질 때 해결 방법 7가지
Cursor 요청 한도 초과 대처법

참고 자료

VS Code 한글 입력 이슈 (GitHub)
Cursor 공식 문서