Glyph missing from font: lỗi chữ tiếng Việt trên Matplotlib
Bài 1/1 · Chương 5
Giải nghĩa lỗi
- 7 phút
- Cơ bản
- Python 3.14
- Cập nhật
Trong bài này · 12
Cảnh báo glyph missing from font của Matplotlib nghĩa là font bạn chọn không có hình vẽ (glyph) cho một chữ cái trên biểu đồ, nên chữ đó thành ô vuông hoặc mất hẳn, tùy font. Với tiếng Việt, chữ hay thiếu là các nguyên âm có hai dấu như ế, ầ, ệ; sửa bằng cách chọn một font có đủ dấu, như DejaVu Sans mặc định, và đặt font đó trong plt.rc_context().
Cần biết trước: tiêu đề, nhãn trục và chữ tiếng Việt và cảnh báo trong Python.
Bảng tra nhanh: font nào đủ chữ tiếng Việt
Matplotlib báo thiếu glyph bằng một UserWarning, tức một cảnh báo: hình vẫn vẽ xong, chỉ có chữ thiếu thành ô vuông hoặc mất hẳn, tùy font. Câu cảnh báo có dạng Glyph 7871 (\N{LATIN SMALL LETTER E WITH CIRCUMFLEX AND ACUTE}) missing from font(s) STIXGeneral.: số 7871 là mã Unicode của chữ thiếu, tên trong ngoặc là tên tiếng Anh của chữ đó, cuối câu là font thiếu nó.
Font có sẵn trong Matplotlib | Chữ tiếng Việt | Ghi chú |
|---|---|---|
| đủ | font mặc định, không cần đặt |
| đủ | chữ có chân, hợp với báo cáo in |
| thiếu | chữ đều khổ cho code |
| thiếu | font cho công thức toán |
| thiếu cả | font LaTeX, kèm cảnh báo riêng |
Font ngoài danh sách này, như Arial hay Roboto, chỉ dùng được khi đã cài trên máy chạy code.
Đọc cảnh báo Glyph missing from font
Cảnh báo in ra luồng lỗi lúc Matplotlib vẽ chữ, không qua print. Để đọc trong chương trình, bắt nó bằng warnings.catch_warnings(record=True) rồi gọi fig.canvas.draw() để Matplotlib vẽ ngay:
import warnings
import matplotlib.pyplot as plt
with (warnings.catch_warnings(record=True) as bat,
plt.rc_context({"font.family": "STIXGeneral"})):
warnings.simplefilter("always")
fig, ax = plt.subplots(figsize=(6.4, 4), layout="constrained")
ax.bar(["Huế", "Đà Lạt", "Cần Thơ"], [284, 351, 307])
ax.set_title("Doanh thu quý 3 (triệu đồng)")
fig.canvas.draw()
plt.show()
so = sorted({int(str(w.message).split()[1]) for w in bat})
print(len(so), "".join(chr(n) for n in so))
for w in bat[:1]:
print(w.category.__name__, str(w.message)[:40])KẾT QUẢ
5 ạầếệồ
UserWarning Glyph 7871 (\N{LATIN SMALL LETTER E WITHDòng đầu đếm và gom các chữ thiếu: ạ của "Lạt", ầ của "Cần", ế của "Huế", ệ và ồ của "triệu đồng". Từ thứ hai của mỗi câu cảnh báo là mã Unicode, chr() đổi mã đó về lại chữ cái; dòng sau là lớp và phần đầu câu của cảnh báo đầu tiên. Trên hình, STIXGeneral bỏ hẳn các chữ đó, không vẽ ô vuông; ô vuông chỉ hiện với font có hình thay thế, như DejaVu Sans Mono. plt.show() nằm trong khối with, vì lúc hiện hình Matplotlib vẽ chữ thêm một lần và cảnh báo lại ra. Đổi "STIXGeneral" thành "DejaVu Sans" rồi chạy lại: chỉ còn một dòng in 0, vì DejaVu Sans đủ mọi chữ nên không còn cảnh báo nào.
Kiểm một font có đủ dấu trước khi dùng
Không cần vẽ thử để biết font thiếu chữ nào. font_manager.findfont() tìm file font theo tên, FT2Font(...).get_charmap() cho bảng các mã chữ có trong font:
from matplotlib import font_manager
from matplotlib.ft2font import FT2Font
def thieu(ten_font, chu):
font = FT2Font(font_manager.findfont(ten_font))
bang = font.get_charmap()
return [c for c in dict.fromkeys(chu)
if c != " " and ord(c) not in bang]
for ten in ["DejaVu Sans", "STIXGeneral", "cmr10"]:
print(ten, thieu(ten, "Doanh thu Huế, Đà Lạt"))KẾT QUẢ
DejaVu Sans []
STIXGeneral ['ế', 'ạ']
cmr10 ['ế', 'Đ', 'à', 'ạ']DejaVu Sans có đủ, hai font còn lại thiếu ít nhất hai chữ. Kiểm với chính chữ sẽ lên biểu đồ, vì một font có thể đủ chữ à mà thiếu ạ.
Đặt font bằng plt.rc_context()
plt.rc_context({...}) đặt cài đặt cho các hình tạo bên trong khối with, rồi trả lại cài đặt cũ khi ra khỏi khối. Hình vẽ trong khối giữ font đã chọn, kể cả sau khi khối kết thúc:
import matplotlib.pyplot as plt
ten = ["Huế", "Đà Lạt", "Cần Thơ"]
with plt.rc_context({"font.family": "DejaVu Serif"}):
fig, ax = plt.subplots(figsize=(6.4, 4), layout="constrained")
ax.bar(ten, [284, 351, 307], label="Quý 3")
ax.set_title("Doanh thu quý 3 theo chi nhánh")
ax.set(xlabel="Chi nhánh", ylabel="Doanh thu (triệu đồng)")
ax.legend()
print(ax.title.get_fontname())
print(plt.rcParams["font.family"])
plt.show()KẾT QUẢ
DejaVu Serif
['sans-serif']Tiêu đề dùng DejaVu Serif, còn cài đặt chung vẫn là sans-serif như trước khối with. Đà Lạt cao nhất với 351 triệu đồng.
Kiểm tra nhanh
Cảnh báo
Glyph 7841 (\N{LATIN SMALL LETTER A WITH DOT BELOW}) missing from font(s) STIXGeneral.cho biết gì?- Biểu đồ không vẽ được, chương trình đã dừng
- Font STIXGeneral không có chữ
ạ, chữ đó không hiện đúng trên hình - Máy chưa cài font STIXGeneral
Lệnh
print(chr(7871))in ra gì?ế7871e
Bạn muốn một biểu đồ dùng font có chân mà không ảnh hưởng các hình khác trong notebook. Cách nào đúng?
plt.rcParams["font.family"] = "DejaVu Serif"ở đầu notebook- Tạo hình bên trong
with plt.rc_context({"font.family": "DejaVu Serif"}): - Đổi sang
"cmr10"vì đó là font có chân
Bài tập
Vẽ biểu đồ cột với font riêng
Viết thân hàm ve_cot_font(ten, doanh_thu, font): vẽ biểu đồ cột với ten là các nhãn cột và doanh_thu là chiều cao, đặt tiêu đề "Doanh thu theo chi nhánh", nhãn trục x "Chi nhánh" và nhãn trục y "Doanh thu (triệu đồng)", tất cả bằng font tên font. Đặt font bằng plt.rc_context(), không đổi cài đặt chung của Matplotlib. Tạo hình bằng plt.subplots(figsize=(6.4, 4), layout="constrained").
Trả về: vùng vẽ của biểu đồ, một Axes.
import matplotlib.pyplot as plt
def ve_cot_font(ten, doanh_thu, font):
pass # Viết thân hàm thay cho dòng nàyTóm tắt
Glyph ... missing from font(s) Xlà UserWarning: font X không có chữ đó, chữ thành ô vuông hoặc mất hẳn tùy font, hình vẫn vẽ.Số trong cảnh báo là mã Unicode;
chr(so)cho ra chữ bị thiếu.DejaVu Sans, font mặc định, và DejaVu Serif có đủ chữ tiếng Việt; STIXGeneral, cmr10, DejaVu Sans Mono thì thiếu.
Kiểm một font bằng
FT2Font(font_manager.findfont(ten)).get_charmap()trước khi dùng.Đặt font cho một hình trong
plt.rc_context(); gánplt.rcParamsthì đổi mọi hình sau.Tên font chưa cài làm Matplotlib lặng lẽ dùng DejaVu Sans.
Câu hỏi thường gặp
Vì sao biểu đồ trên Colab hiện tiếng Việt đúng mà trên máy tôi thành ô vuông?
Font mặc định của Matplotlib là DejaVu Sans, đủ dấu. Máy bạn có thể có file cấu hình matplotlibrc hay một dòng plt.rcParams trong code đổi sang font khác. In plt.rcParams["font.family"] và plt.rcParams["font.sans-serif"][:3] để xem font đang dùng; bài tiêu đề, nhãn trục và chữ tiếng Việt nhắc lại cài đặt mặc định.
Muốn dùng font Be Vietnam Pro hay Roboto thì làm thế nào?
Cài file font lên máy, rồi gọi font_manager.fontManager.addfont(duong_dan) với đường dẫn tới file .ttf để Matplotlib biết font đó, sau đó đặt tên font trong rc_context(). Kiểm bằng hàm thieu() ở trên trước khi vẽ.
Lưu hình bằng savefig thì chữ có thành ô vuông không?
Có, nếu hình vẽ bằng font thiếu glyph: savefig() ghi đúng thứ Matplotlib đã vẽ. Hình lưu dạng PDF hay SVG còn cần font được nhúng vào file, như bài lưu hình bằng savefig giải thích.
Có nên tắt cảnh báo glyph cho gọn không?
Không nên: cảnh báo là cách duy nhất để biết hình có chữ ô vuông trước khi người xem thấy. Hãy đổi font cho tới khi cảnh báo hết, như bài cảnh báo trong Python khuyên với mọi cảnh báo.
Chủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE
- Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
- Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
- Xây hệ thống AI cho doanh nghiệp tại VietPlatform.