한글/인코딩/경로 이슈 특화 가이드
개발 환경에서 한국 사용자들을 괴롭히는 고질적인 문제들을 해결합니다.
1. Windows 사용자 계정명/경로 한글 문제
계정 이름이 한글일 경우 일부 도구가 설치되지 않거나 설정 파일(.m2, .npm 등)을 찾지 못합니다.
- 해결책: 가급적 영문 계정명을 사용하세요.
- 우회로:
C:\dev같은 영문 경로를 생성하고 환경 변수(HOME, USERPROFILE)를 해당 경로로 임시 지정하거나, 심볼릭 링크(mklink)를 활용하세요.
2. Git 한글 파일명 깨짐 (Status/Log)
터미널에서 git status 입력 시 한글 파일명이 \234\123... 처럼 보일 때.
git config --global core.quotepath false
위 명령어를 입력하면 유니코드 파일명이 정상적으로 표시됩니다.
3. IDE (IntelliJ/VS Code) 인코딩 설정
파일을 열었을 때 한글 주석이 깨지는 경우입니다. 프로젝트 전체를 UTF-8로 통일해야 합니다.
- IntelliJ: Settings -> Editor -> File Encodings -> Global/Project Encoding을 모두
UTF-8로 변경.Transparent native-to-ascii conversion체크 권장. - VS Code:
Files: Encoding설정을utf8로 지정.
4. 터미널(PowerShell/CMD) 출력 깨짐
로그나 출력 결과가 깨져 보일 때 코드 페이지를 변경합니다.
- PowerShell:
$OutputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 - CMD:
chcp 65001(UTF-8로 변경) - Permanently: 시스템 설정 -> 시간 및 언어 -> 언어 -> 관리 언어 설정 -> 시스템 로캘 변경 -> 'Beta: 세계 언어 지원을 위해 유니코드 UTF-8 사용' 체크 (주의: 일부 구형 앱 호환성 문제 발생 가능)