레이아웃/언어별 입력 이슈(한글/영문/IME 등)

USB HID 키보드 입력은 “문자”를 보내는 게 아니라 “키(키코드 + modifier)”를 보냅니다. 따라서 언어/레이아웃/IME 상태에 따라 결과 문자가 달라질 수 있습니다.

Q. 왜 같은 키 입력인데 문자 결과가 달라지나요?

문자는 OS의 키보드 레이아웃과 IME가 결정합니다. 예를 들어 Shift+2가 `@`인지 다른 문자인지는 레이아웃에 따라 달라집니다.

한/영 전환(IME 토글) 안정화 팁

• 시작 전 타깃 입력기를 가능한 한 영문 상태로 맞추고 시작
• 토글 키(예: Right Alt/CapsLock 등)는 환경마다 다름
• 토글 직후에는 Mode Switch Delay가 필요할 수 있음

자주 발생하는 증상과 처방

증상: 한글이 깨진다/중간이 섞인다

• modeSwitchDelayMs 증가
• typingDelayMs 증가(조합 안정화)
• 테스트는 메모장 → 성공 후 IDE로

증상: 특수문자가 다른 문자로 찍힌다

• Target PC의 키보드 레이아웃(US/KO) 확인 및 고정
• 테스트/운영 환경에서 동일 레이아웃 유지

권장 입력 테스트 세트

• ASCII: `ABC abc 123`, `[]{}()<>`, `!@#$%^&*_-+=`
• 개행/탭: `line1\n\tindent\nline3`
• 한글: `한글 테스트: 가나다라마바사`, `abc한글def`

원본(Markdown): docs/ime-layout-issues.md