跳转至

Linux开发常见问题 - 开发环境类

本类汇总 Linux 平台开发过程中在 PC / 虚拟机侧 遇到的常见问题,涵盖虚拟机部署、系统资源、开发工具及编译环境等场景。

1. 虚拟机主分区空间不足无法进入系统

故障现象

虚拟机启动后卡在开机自检画面,无法正常进入操作系统。

解决方法

①:进入文本终端

在虚拟机启动卡住的自检画面,按下组合键 Ctrl + Alt + F2 进入文本终端界面。

②:登录系统

在文本终端中,输入以下用户名和密码登录系统:

参数名 参数
用户名 wecon
密码 wecon2026

③:清理磁盘空间并重启

登录成功后,执行以下命令清理不必要的文件,释放磁盘空间:

# 查看磁盘使用情况,确认空间不足
df -h

# 清理系统日志(保留最近1天)
sudo journalctl --vacuum-time=1d

# 清理临时文件
sudo rm -rf /tmp/* /var/tmp/*

# 清理APT软件包缓存
sudo apt-get clean
sudo apt-get autoclean
sudo apt-get autoremove -y

# 重启虚拟机
sudo reboot

注意事项

  • 删除文件前请确认文件重要性:避免删除系统关键文件
  • 迁移文件时确保文件权限正确:迁移工程文件时注意文件权限设置
  • 定期备份重要数据:防止数据丢失
  • 建议将工程文件或大文件放在 /mnt/data 分区:避免占用系统分区空间

2. 虚拟机磁盘扩容后空间未生效

故障现象

在 VMware 中将虚拟磁盘扩容至 50GB 后,Ubuntu 系统仍显示根分区只有 29.5GB,使用 GParted 提示根分区正在使用,无法直接扩容。

可能原因

VMware 扩容只增加了虚拟磁盘容量,系统内部的实际分区(根分区)尚未扩展,需要在 Ubuntu 内继续扩展分区。

解决方法

# ① 安装分区扩展工具
sudo apt install cloud-guest-utils -y

# ② 扩展根分区(示例设备为 /dev/sda,分区号为 3,请按实际设备调整)
sudo growpart /dev/sda 3

# ③ 在线扩展 ext4 文件系统
sudo resize2fs /dev/sda3

执行完成后使用 df -h 确认根分区容量已扩展。


3. 虚拟机运行卡顿、键盘输入卡死

故障现象

开发过程中虚拟机键盘输入卡顿,严重时完全卡死;部分情况下虚拟机连接不上设备。

可能原因

Ubuntu 的画面输出模式为 Wayland,VMware 对 Wayland 支持不完善。

解决方法

将 Ubuntu 的画面输出模式由 Wayland 切换为 X11,重启后即可解决。


4. 系统 / Qt 程序界面卡死、代码编辑窗口绘制残留

故障现象

  • 虚拟机系统、Qt Creator 界面比较容易卡死。
  • Qt Creator 代码编辑窗口上下滚动、选中文本时出现绘制残留、残影、撕裂。

可能原因

Qt Creator 硬件加速(OpenGL)与虚拟机显卡驱动存在兼容性问题,导致界面渲染异常。

解决方法

①:切换显示服务为 X11

若 Ubuntu 使用 Wayland,VMware 对其支持不完善,易导致卡顿。将画面输出模式由 Wayland 切换为 X11 并重启,可解决大部分卡顿问题。

②:使用软件渲染模式启动 Qt Creator

临时验证:

QT_QUICK_BACKEND=software qtcreator

③:永久生效

修改 Qt Creator 桌面启动项(.desktop 文件),将启动命令固化为软件渲染模式:

Exec=env QT_QUICK_BACKEND=software qtcreator %F

若问题依旧,请检查虚拟机分配的内存 / CPU 是否充足,适当调大配置。


5. Qt 调试功能异常、程序无法部署、设备无法 ping 通

故障现象

  • Qt Creator 调试 / 部署功能异常,无法将程序部署到设备。
  • 虚拟机与设备之间无法 ping 通,SSH 无法连接。

排查与解决方法

①:检查网络连通性

确认虚拟机和设备处于同一网段:

# 查看虚拟机 IP
ifconfig
# 测试与设备连通性
ping <设备IP>
  • 若无法 ping 通,检查虚拟机网络是否为桥接模式,并将虚拟机和设备配置为同一网段静态 IP。

②:清除 SSH 缓存

当设备 IP 变更或 SSH 指纹冲突导致部署失败时,清除虚拟机 SSH 缓存后重试:

rm -rf /home/wecon/.ssh/*

③:检查 Qt Creator 设备配置

  • 确认 Devices 中设备 Host name(IP)、Username(root)、密码正确。
  • 点击 Test 测试连接,确认能成功连接。

④:检查设备侧空间

设备 /usr 分区空间不足也会导致部署失败,使用 df -h 检查并清理空间(见设备存储类常见问题)。

⑤:检查设备网络状态

  • 确认设备已获取 / 设置正确的 IP 地址。
  • 无网口设备请通过 USB 网络(RNDIS)或 U盘脚本部署(见系统结构与调试指南)。

6. APT 软件源无法连接

故障现象

Ubuntu 使用阿里云 APT 软件源执行 sudo apt update 时提示无法连接 mirrors.aliyun.com,但浏览器访问百度、微博等网页正常。

排查方法

先确认虚拟机网络正常,问题集中在镜像站访问:

# 测试镜像站连通性
ping mirrors.aliyun.com
curl -I https://mirrors.aliyun.com

解决方法

若阿里云镜像不可达,将 APT 软件源更换为清华源后重新执行 sudo apt update。

若 apt update 提示软件更新服务占用或 appstream 配置异常:

# 清理 appstream 缓存及 APT 缓存后重试
sudo apt update -o APT::Update::Post-Invoke-Success::=""
sudo rm -rf /var/cache/app-info
sudo apt clean
sudo apt update

7. Ubuntu 22.04 依赖包名不匹配

故障现象

按照旧教程(Ubuntu 18.04)搭建环境时,执行 sudo apt install libncurses5 libncursesw5 libpython2.7 -y 提示包不存在或找不到软件包。

可能原因

旧版教程基于 Ubuntu 18.04,其软件源中的 ncurses 包名为 libncurses5;Ubuntu 22.04 已更换为 libncurses6。

解决方法

sudo apt update
sudo apt install libncurses6 libncursesw6 python3 -y

8. Qt Creator 编译常见问题

编译提示 "Unexpected output from remote process: Available"

①:点击左侧工具栏 Projects。

②:点击工程 Run 进入其配置选项。

③:关闭 Check for free disk space 功能。

工程编译时报库文件错误

排查思路:

  1. SDK 放置路径错误:确认 SDK 解压路径与 Qt Creator 中配置的路径一致,修正后重新编译。
  2. .a 库与 .so 库混用:将 .a 静态库替换为 .so 动态库,并在 .pro 文件中同步修改。
  3. SDK 解压时软链接丢失:重新解压 SDK(在 Linux 下解压,避免在 Windows 解压后拷贝导致软链接失效)。
  4. 依赖库版本不一致(如 libts):使用 find / -name "libts*" 2>/dev/null 检查设备端库文件,确认与编译依赖的库版本匹配,并使用新 SDK 重新编译。

9. 系统版本检测

快速检测命令

通过 SSH 工具登录设备后台,执行 env 命令检查是否存在 HMI_LOCAL_ROOT 环境变量。若存在则判定为 Linux_V2.0 版本分区;若不存在,则为 Linux_V1.0 版本分区。

系统版本 发布日期 维护情况
通用Linux_V1.0版本 2023 停止维护
通用Linux_V2.0版本 2025 维护至今