Pillow使用KhmerOScontent字体渲染高棉语显示异常如何解决？

问题根因 #

• 高棉语属于需要*复杂文本排版（Complex Text Layout, CTL）*支持的语言，涉及辅音声母、元音附标、声调符号的组合堆叠、上下文变形规则，Pillow原生的文本渲染接口没有集成CTL支持，无法正确解析高棉语的字形组合逻辑，哪怕字体本身没有问题，渲染出来也会出现字符错位、拆分显示的问题。
• 你当前使用的draw.text和draw.multiline_text均为Pillow原生接口，天生不支持高棉语、缅甸语、阿拉伯语这类需要特殊排版规则的文字。

可行解决方案 #

方案1：搭配pangocairo渲染高棉语后合并到原图（兼容性最优） #

该方案通过对复杂脚本支持最成熟的pango+cairo组合渲染高棉语文本，生成透明背景的文字图层后粘贴到你原有Pillow生成的底图上即可。
首先安装依赖：

pip install pycairo pangocairo pillow

参考代码片段：

import cairo
import pangocairo
import pango
from PIL import Image

# 高棉语文本渲染函数
def render_khmer_text(text, font_family="Khmer OS Content", font_size=10):
    # 预计算文本所需尺寸
    tmp_surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, 0, 0)
    tmp_cr = cairo.Context(tmp_surface)
    pc = pangocairo.CairoContext(tmp_cr)
    layout = pc.create_layout()
    font_desc = pango.FontDescription(f"{font_family} {font_size}")
    layout.set_font_description(font_desc)
    layout.set_text(text)
    width, height = layout.get_pixel_size()
    # 生成对应尺寸的透明画布渲染文字
    surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, width, height)
    cr = cairo.Context(surface)
    pc = pangocairo.CairoContext(cr)
    layout = pc.create_layout()
    layout.set_font_description(font_desc)
    layout.set_text(text)
    cr.set_source_rgb(0, 0, 0) # 黑色文字，可按需调整色值
    pc.show_layout(layout)
    # 转换为PIL Image对象
    return Image.frombuffer("RGBA", (width, height), surface.get_data(), "raw", "BGRA", 0, 1)

# 原有逻辑生成底图后调用渲染函数，粘贴到对应位置即可
# 示例：渲染名称文本后居中粘贴到底图坐标(w/2,110)位置
name_img = render_khmer_text(wrap_name, font_size=10)
paste_x = int((w - name_img.width) / 2)
paste_y = 110 - name_img.height // 2
base_img.paste(name_img, (paste_x, paste_y), mask=name_img)

方案2：静态文本预生成素材 #

如果需要展示的高棉语文本是固定内容，可以提前用设计工具将文本导出为透明PNG素材，直接调用粘贴到底图，无需额外引入依赖。

方案3：升级Pillow版本搭配libraqm #

Pillow 9.1及以上版本支持通过集成libraqm库处理复杂文本，你可以先安装对应系统的libraqm依赖，调用text方法时添加参数embedded_color=False尝试渲染，该方案对高棉语的支持稳定性弱于方案1。

内容的提问来源于stack exchange，提问作者Yoki Watanabe