[Bug Fix Log] Tkinter에서 한글이 깨질 때 해결 방법

 

[Setup Log] Tkinter에서 한글이 깨질 때 해결 방법

Tkinter를 사용해 Python GUI를 만들 때, 한글이 네모(□)나 물음표(?)로 깨져 보이는 현상이 자주 발생합니다. 이는 Tkinter 기본 폰트가 한글을 지원하지 않기 때문입니다. 아래의 방법으로 해결할 수 있습니다.

✅ 1. 한글 폰트 설치

Ubuntu 또는 WSL 환경에서 아래 명령어로 한글 폰트를 설치합니다.

sudo apt update
sudo apt install fonts-nanum fonts-nanum-coding fonts-noto-cjk

설치 후, 다음 명령어로 폰트가 설치되었는지 확인할 수 있습니다:

fc-list :lang=ko | grep -i nanum

✅ 2. Tkinter 코드에서 폰트 적용

폰트 이름을 직접 지정하여 Label 등에 적용합니다.

import tkinter as tk

root = tk.Tk()
tk.Label(root, text="안녕하세요. 주식 분석기입니다!", font=("NanumGothic", 12)).pack()
root.mainloop()

✅ 3. 기본 폰트 전체 설정

모든 위젯에 기본 적용되는 폰트를 설정하려면 아래처럼 작성합니다:

import tkinter as tk
import tkinter.font as tkFont

root = tk.Tk()
default_font = tkFont.nametofont("TkDefaultFont")
default_font.configure(family="Noto Sans CJK KR", size=12)

tk.Label(root, text="전체 기본 폰트 적용!").pack()
root.mainloop()

✅ 4. 여전히 안 될 경우

• fc-cache -fv 실행 후 시스템 재시작
• 폰트 이름 정확히 일치하는지 확인
• fc-list :lang=ko로 전체 한글 폰트 목록 확인

📌 요약

문제	해결 방법
한글이 네모로 깨짐	폰트 설치 후 Tkinter에 font=(...) 명시
폰트 설치해도 안 나옴	fc-cache -fv 실행, 정확한 폰트 이름 확인
전체 위젯에 폰트 적용	tkFont.nametofont("TkDefaultFont").configure(...)

🏷️ 태그

Tkinter, 한글 깨짐, 폰트 설정, Python GUI, fonts-nanum, WSL, Ubuntu, Setup Log