Git 한글 파일명 깨짐 해결 (core.quotePath)

터미널 환경이 UTF-8임에도 불구하고 git status 등에서 한글 파일명이 \353\241\234...와 같은 8진수(Octal Escape) 코드로 표시된다면, 이는 Git의 기본 출력 설정 때문입니다.

---

터미널 Locale 확인 방법

먼저 터미널 자체가 한글 인코딩을 지원하는 설정인지 확인해야 합니다. 아래 명령어를 입력합니다.

locale

체크포인트:

• 출력 내용 중 LANG 또는 LC_ALL 항목이 ko_KR.UTF-8 또는 C.UTF-8로 되어 있는지 확인합니다.
• 값에 UTF-8이 포함되어 있다면 터미널 인코딩 설정은 정상입니다.

---

원인 분석

Git은 기본적으로 0x80 이상의 문자가 포함된 파일명을 인용 부호(" ")로 감싸고 8진수로 이스케이프 처리합니다. 이는 서로 다른 OS 간의 호환성을 위한 기본 동작이지만, 한국어 환경에서는 가독성을 저해하는 원인이 됩니다.

---

해결 방법: core.quotePath 설정 변경

Git 설정을 통해 이스케이프 처리를 비활성화하면 한글이 정상적으로 표시됩니다.

현재 저장소에만 적용:

git config core.quotePath false

모든 저장소에 전역 적용:

git config --global core.quotePath false

---

4. 설정 결과 비교

설정 전후의 출력 차이는 다음과 같습니다.

설정 전 (Octal Escape 적용)

• "\353\241\234\34values..."

설정 후 (정상 표시)

• "한글테스트.md"

---

터미널 Locale이 정상임에도 한글 파일명이 깨져 보인다면, `core.quotePath` 설정을 가장 먼저 확인해 보시기 바랍니다.