WSL(ubuntu)安装串口工具vofa+，软件中文乱码

一、前言

最近在使用 WSL 开发 ESP32 的时候，经常会使用到串口，但是每次都是在 WSL（ubuntu）里面编译代码，下载代码，又要把 USB设备切到WINDWOS很麻烦。所以就找了一个解决方案，在 Ubuntu里面安装串口工具(Vofa+) 已经中途遇到的问题。

二、安装软件

• 下载 vofa+

下载中心 | VOFA-Plus上位机

安装串口工具，软件中文乱码/image-20240327155727577.png)

• 移动到你的 Ubuntu 里面去

安装串口工具，软件中文乱码/image-20240327160238734.png)

lim: 是 Ubuntu 的用户名，请改成自己的用户名

softInstall: 新建的文件夹

• 打开 WSL ubuntu 终端

• 安装 vofa+

  sudo dpkg -i vofa+_1.3.10_amd64.deb
  

  

三、报错解决

3.1运行vofa+ 报错（QT5启动失败）

这个是因为 QT5的组件库出现问题，导致没有启动起来

• 如果没有安装 QT5 先安装 QT5

sudo apt-get install qt5-image-formats-plugins

• 修改配置文件 ~/.bashrc

vim ~/.bashrc

• 在最末尾添加如下语句，会在 Vofa+启动时，列出详细的错误提示

export QT_DEBUG_PLUGINS=1

• 保存退出编辑，使配置文件生效：

source ~/.bashrc

• 启动 vofa+ 会弹出如下详细错误信息,找到了引发错误的真正原因，如果没有报错直接跳过

也就是Qt动态链接库的问题，

• 进入目录，替换成自己的目录

  cd /opt/vofa+/plugins/platforms/
  

• 运行 ldd libqxcb.so，查看关联内容：

  ldd libqxcb.so
  

这里有两个库没有，需要自己安装一下， libxkbcommon-x11.so.0 ， libxkbcommon.so.0 。

• 安装依赖库

  如果有多个，也要安装

  sudo apt-get install libxkbcommon-x11-0 libxkbcommon0
  

• 安装完以后重新运行

  vofa+
  

但是运行是乱码，这个是第二个问题，需要解决。

• 取消运行软件打印详细错误

  刚刚是为了调试错误，把环境变量修改了，现在该回去

  取消环境变量

  vim ~/.bashrc
  

  删除刚刚增加的那一行

  更新缓存

  source ~/.bashrc
  

3.2 运行软件中文字符是乱码

这个是因为 Ubuntu里面还没有中文的字库

1. 下载中文字库

sudo apt-get install fonts-wqy-zenhei

这将安装文泉驿正黑或其他中文字体包。您也可以根据需要选择其他中文字体包进行安装。

2. 刷新字体缓存

安装完字体后，您可能需要刷新系统的字体缓存。运行以下命令：

sudo fc-cache -fv

这将更新系统的字体缓存，使新安装的字体生效

3. 重启 vofa+

尝试重新启动该应用程序，以便它能够加载新安装的字体。

---

文章是自己总结而记录，有些知识点没说明白的，请各位看官多多提意见，多多交流，欢迎大家留言
如果技术交流可以加以下群，方便沟通