Bỏ qua đến nội dung chính
Mục lục

Glyph missing from font: lỗi chữ tiếng Việt trên Matplotlib

AIDev Team · duyệt: Nguyễn Việt Chung

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

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ú

DejaVu Sans

đủ

font mặc định, không cần đặt

DejaVu Serif

đủ

chữ có chân, hợp với báo cáo in

DejaVu Sans Mono

thiếu ế, ầ…

chữ đều khổ cho code

STIXGeneral

thiếu ạ, ế, ồ…

font cho công thức toán

cmr10

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:

python
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 WITH
Biểu đồ cột doanh thu quý 3 của ba chi nhánh vẽ bằng font STIXGeneral; các chữ ạ, ầ, ế, ệ, ồ biến mất, tên thành Hu, Đà L t, C n Thơ.

Dò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:

python
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:

python
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']
Biểu đồ cột doanh thu quý 3 bằng font có chân DejaVu Serif: Huế 284, Đà Lạt 351, Cần Thơ 307 triệu đồng; mọi chữ có dấu hiện đúng, chú giải ghi Quý 3.

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

  1. 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
  2. Lệnh print(chr(7871)) in ra gì?

    • ế
    • 7871
    • e
  3. 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
Đúng hết lần đầu +15 XP

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.

python
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ày

Tóm tắt

  • Glyph ... missing from font(s) X là 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án plt.rcParams thì đổ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ủ đề

glyph missing from font

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

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.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập