使用Python3在Waveshare 7.5英寸显示屏显示特殊字符问题咨询

架构老林

2026-9-29

问题根因

该问题核心是Waveshare墨水屏官方驱动默认绑定的点阵字库字符集覆盖不全：官方预设的字库仅包含基础ASCII字符和少量提前适配的特殊符号（你能正常显示的度符号就属于提前适配的范畴），上标字符、部分符号没有预绘制对应的字形，调用时找不到匹配资源就会渲染为空白。

修复步骤

替换默认点阵字库为全字符集矢量字库
不要直接用官方例程自带的Font类加载固定点阵字体，改用Pillow库的ImageFont模块加载树莓派系统自带的全字符集矢量字库，默认预装的FreeSans、Noto Sans系列字库均覆盖了你需要的上标、百分号等符号，示例代码如下：
```
from PIL import ImageFont
# 字号可根据你的显示需求调整
font = ImageFont.truetype("/usr/share/fonts/truetype/freefont/FreeSans.ttf", 24)
```
不确定字体路径的话可执行fc-list命令查看系统已安装字体的完整路径，选择字符集覆盖全的字体即可。
补充编码声明（Python开发场景）
在代码首行添加UTF-8编码声明，确保特殊字符被正确解析，无需额外转义就能直接写入字符串：
```
# -*- coding: utf-8 -*-
```
配置完成后可以直接在字符串中写°、²、%等符号，不需要用\N转义也能正常识别。
先本地验证渲染效果再推屏
调试阶段先把内容渲染到PIL的Image画布上，保存为本地图片查看是否有空白，排除绘制阶段的问题后再推送到墨水屏刷新，避免不必要的屏幕损耗。如果是多色墨水屏还要确认字符颜色和底色对比度足够，不会因为颜色接近误认为是空白。
（可选）裁剪自定义字库
如果你的树莓派配置较低、内存紧张，可以用fonttools工具按需裁剪字库，仅保留你需要用到的字符，进一步降低资源占用。