기술블로그

🧠 WSL에서 SQLite 한글 깨짐 해결하기 – 한글 폰트 설치부터 설정까지

Chansman 2025. 4. 30. 17:51

🧠 WSL에서 SQLite 한글 깨짐 해결하기 – 한글 폰트 설치부터 설정까지


✅ 문제 상황

WSL에서 SQLite DB를 GUI 도구(DB Browser for SQLite 등)로 열었을 때,
한글이 "???" 또는 깨진 글자로 표시되는 현상이 발생합니다.


✅ 원인

SQLite 자체는 UTF-8을 지원하지만,
사용 중인 GUI 툴이 한글을 표시할 수 있는 폰트를 사용하지 않아서 생기는 문제입니다.


✅ 해결 방법 – 한글 폰트 설치

🛠 1. Noto Sans CJK 폰트 설치 (Google 폰트 – 권장)

sudo apt update
sudo apt install fonts-noto-cjk -y

🛠 2. 추가 한글 폰트 설치 (선택)

sudo apt install fonts-nanum -y          # 나눔 고딕
sudo apt install fonts-unfonts-core -y   # 은 글꼴

✅ SQLite Browser에서 한글 폰트 설정

  1. DB Browser for SQLite 실행
  2. 메뉴 → Edit > Preferences (환경 설정)
  3. 탭에서 Data Browser 선택
  4. Display Font 항목 클릭 → 한글 폰트 선택:
    • Noto Sans CJK KR
    • Nanum Gothic
    • UnDotum 등
  5. 설정 저장 후 프로그램 재시작

✅ 정상 작동 예시

항목 설정 전 설정 후

name 값 ??? 또는 깨진 글자 구글, 네이버 등 한글 정상 표시

✅ 요약 정리

항목 내용

원인 폰트가 한글을 지원하지 않음
해결 fonts-noto-cjk, fonts-nanum 설치
위치 Edit > Preferences > Display Font 설정
반영 시점 프로그램 재시작 후 적용됨

WSL에서도 한글 폰트를 설치하고 설정만 바꾸면,
SQLite GUI 도구에서 한글을 깨짐 없이 깔끔하게 확인할 수 있습니다! 😄