You need to enable JavaScript to run this app. SQL Workbench在Ubuntu UTF-8环境下脚本方块乱码 如何正常显示SQL语句
优惠活动
大模型
产品
解决方案
定价
更多

SQL Workbench在Ubuntu UTF-8环境下脚本方块乱码 如何正常显示SQL语句

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

安装缺失的依赖字体

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 12:06:04