Ubuntu16.04下Python3.6虚拟环境Tkinter GUI字体模糊无法调用自定义字体

解决步骤 #

1. 确认Tkinter实际可识别的字体列表 #

系统安装的字体需要被Tkinter成功加载才能调用，先运行以下代码打印所有Tk可识别的字体，确认你要使用的Lato、Helvetica是否在列表中：

from tkinter import Tk, font
root = Tk()
print(font.families())
root.destroy()

如果搜索不到对应字体，继续执行后续步骤。

2. 刷新系统字体缓存 #

手动刷新字体缓存，强制系统重新加载所有字体文件：

fc-cache -fv

执行完成后重启Python进程，重新运行上面的字体列表查询代码确认是否能搜到目标字体。

3. 安装Tkinter字体渲染依赖 #

Ubuntu 16.04环境下Tkinter默认可能缺少字体渲染的依赖库，导致无法加载系统安装的第三方字体，执行以下命令安装依赖：

sudo apt update
sudo apt install -y fontconfig tk8.6 libxft2 libfreetype6

4. 使用准确的字体家族名称 #

字体的调用名称需要和系统识别的正式家族名完全一致，不能简写，执行以下命令查询Lato字体的准确名称：

fc-list | grep -i lato

输出示例如下，取冒号后第一个字段为正式字体名：

/usr/share/fonts/truetype/lato/Lato-Regular.ttf: Lato:style=Regular

此时字体家族名应为Lato，如果输出中带后缀，需要完整复制，比如部分字体可能显示为Lato Regular，必须填写完整名称再调用：

# 替换为你查询到的准确字体名
tab_Font = Font(family="Lato", size=13)

5. 修复虚拟环境依赖问题 #

如果是虚拟环境单独安装的Python/Tkinter，可能没有链接系统的字体渲染库，可删除原有虚拟环境，使用带系统依赖的方式重建：

# 替换为你的虚拟环境路径
rm -rf ./venv
# 重建虚拟环境，继承系统已安装的包（包含带fontconfig支持的Tkinter）
python3.6 -m venv --system-site-packages ./venv
source ./venv/bin/activate
# 重新安装你的项目依赖

6. 测试字体是否生效 #

完成上述操作后，运行测试代码验证：

from tkinter.font import Font
print(Font(family="Lato", size=13).actual())

如果返回的family字段为你设置的目标字体，即为配置成功。

内容的提问来源于stack exchange，提问作者Asiya Naqvi