SQL Workbench在Ubuntu UTF-8环境下脚本方块乱码 如何正常显示SQL语句
问题定位
- 故障核心特征:Ubuntu系统采用UTF-8编码配置,SQL Workbench软件原生UI为英文显示正常,但SQL脚本编辑区的所有内容(包括标准英文SQL语句如
SELECT * FROM table;)全部显示为方块状占位乱码 - 核心根因:该问题不属于字符编码不兼容类故障——编码匹配错误只会出现字符替换为无意义乱码文本,不会出现所有文本都渲染为空心方块的表现,故障本质是代码编辑区的渲染字体资源缺失,和系统编码、软件UI语言设置无关
- 故障参考效果:

解决方案
安装缺失的依赖字体
SQL Workbench的Linux版本默认关联等宽字体作为代码编辑区的渲染字体,Ubuntu精简环境默认不会预装这类字体,在终端执行以下安装命令即可补齐资源:
sudo apt update sudo apt install fonts-liberation fonts-dejavu-core
校准软件内字体配置
安装完成后重启SQL Workbench,按以下路径调整设置:
- 进入顶部菜单栏
Edit > Preferences - 定位到
Editor > Font配置板块 - 将异常的默认字体选项,替换为已安装的
Liberation Mono或DejaVu Sans Mono等宽字体 - 保存配置后编辑区即可正常显示英文SQL脚本内容
特殊场景兜底排查
如果安装字体、调整配置后仍存在方块乱码,逐一排查以下场景:
- 检查系统是否启用了强制字体替换规则,若存在将等宽字体替换为不含英文ASCII字符的占位字体的规则,将该规则关闭
- 若SQL Workbench是通过snap沙盒包安装,需确认snap的字体目录访问权限已开启;权限受限导致字体加载失败时,更换官方deb源版本的安装包即可解决
内容的提问来源于stack exchange,提问作者Tan Wen Zhong
相关产品推荐
相关产品推荐

