LabelImg界面字体设置：解决中文显示乱码问题

在使用LabelImg进行图像标注时，中文显示乱码是常见问题，尤其影响标注效率和准确性。本文将从问题根源出发，提供两种实用解决方案，帮助用户快速解决界面字体显示异常问题。

问题分析：为什么会出现中文乱码？

LabelImg作为跨平台标注工具，默认字体配置可能未针对中文环境优化。通过分析libs/settings.py配置文件和主程序代码发现，界面字体设置存在两个关键问题：

1. 字体族缺失：在labelImg.py第1220行中，仅动态计算了字体大小（self.canvas.label_font_size = int(0.02 * max(self.image.width(), self.image.height()))），未指定支持中文的字体族
2. 系统字体差异：Windows、macOS和Linux系统默认字体对中文支持程度不同，尤其在Linux环境下易出现方块乱码

解决方案一：通过配置文件修改字体

适用于普通用户的快速修复方案，无需修改代码即可生效：

1. 关闭LabelImg程序
2. 找到配置文件：
   • Windows：C:\Users\用户名\.labelImgSettings.pkl
   • macOS/Linux：~/.labelImgSettings.pkl
3. 使用文本编辑器打开，添加字体配置：

   # 在data字典中添加
   "font_family": "SimHei, WenQuanYi Micro Hei, Heiti TC",
   "font_size": 12
   

4. 保存文件并重启LabelImg

配置原理：libs/settings.py第5-45行定义了配置加载逻辑，程序启动时会读取该文件并应用字体设置

解决方案二：代码层面彻底修复

适用于开发者或需要长期使用的场景，通过修改源码确保中文显示正常：

1. 打开主程序文件labelImg.py
2. 找到第83行（settings = self.settings），在下方添加字体配置代码：

   # 设置全局字体支持中文
   font_family = settings.get("font_family", "SimHei, WenQuanYi Micro Hei, Heiti TC")
   font_size = settings.get("font_size", 12)
   font = QFont(font_family, font_size)
   QApplication.setFont(font)
   

3. 修改第1220行的字体大小计算逻辑：

   # 原代码：self.canvas.label_font_size = int(0.02 * max(self.image.width(), self.image.height()))
   # 修改为：
   self.canvas.label_font_size = settings.get("label_font_size", font_size)
   

4. 重新运行程序：python labelImg.py

工具函数参考：libs/utils.py第18-50行提供了界面组件创建工具，确保字体设置在所有控件中生效

验证与测试

修改完成后，可通过以下步骤验证效果：

1. 打开包含中文标签的图像文件
2. 创建新标注框并输入中文标签
3. 检查标签文本是否清晰显示，无方块或乱码
4. 测试不同缩放级别下的字体显示效果（使用界面缩放控件）

若问题仍存在，可尝试更换字体族配置，推荐中文字体优先级：

• Windows："SimHei, Microsoft YaHei, Arial"
• macOS："Heiti TC, PingFang SC, SimHei"
• Linux："WenQuanYi Micro Hei, Heiti TC, Sans-serif"

总结

通过配置文件或代码修改两种方式，均可有效解决LabelImg的中文显示乱码问题。普通用户推荐使用配置文件方式，操作简单且无需编程知识；开发环境则建议采用代码修改方案，确保团队协作时配置一致性。项目配置文件libs/settings.py和主程序labelImg.py是关键修改对象，建议修改前备份相关文件。