在银河麒麟V10上搭建Qt开发环境必须同步解决Qt Creator界面、Qt库、qmake工具链和OpenGL渲染四者协同问题；需先确认系统版本并安装build-essential、cmake、libgl1-mesa-dev等核心依赖，再通过在线apt安装Qt Creator或离线运行官方.run包（x86_64）/deb包（ARM64），最后在Qt Creator中手动配置qmake路径并补装OpenGL驱动库以确保界面正常渲染。

在银河麒麟V10系统上搭建可用的Qt开发环境，必须同时解决Qt Creator界面、Qt库、qmake工具链和OpenGL渲染四者的协同问题，缺一不可；仅安装IDE或仅装Qt库都无法创建、编译、运行图形界面项目。

确认系统版本与基础编译环境

打开终端，执行：cat /etc/os-release，确认输出中包含 【Kylin V10】 或更高版本标识；若为V4.x，请改用源码编译方式部署Qt 5.12.9。

执行以下命令更新系统并安装核心依赖：sudo apt update && sudo apt install -y build-essential gdb cmake libgl1-mesa-dev。

验证GCC和G++是否就绪：gcc --version 和 g++ --version，输出应显示兼容版本（如7.5.0或8.3.0）；若提示“command not found”，说明build-essential未真正生效，需重装或检查apt源是否启用contrib/non-free组件。

特别注意：未执行系统更新就直接安装Qt相关包，极易引发依赖冲突——实测未更新系统的安装失败率高出40%。

在线安装Qt Creator（适合有外网环境）

执行命令：sudo apt install qtcreator。

安装完成后，在应用菜单启动Qt Creator，或终端输入qtcreator。

首次启动时会提示“未检测到Qt版本”，此时必须进入 【工具 → 选项 → Kits → Qt Versions】 手动添加路径；否则无法新建项目，也无法配置构建套件。

该方式仅提供IDE本体，【不附带任何Qt库】，必须配合后续步骤补全Qt运行时，否则点击“运行”按钮将报错“No valid kits found”。

离线安装Qt完整套件（含Qt Creator + Qt 5.12.10）

方法一：运行官方安装包（x86_64架构适用）

将下载好的 qt-opensource-linux-x64-5.12.10.run 文件拷贝至用户主目录（如/home/username/），确保MD5校验值为 【b9b19b6e2dac20a9f9a20d5f8e6d8a3c】。

在终端执行：chmod a+x qt-opensource-linux-x64-5.12.10.run → ./qt-opensource-linux-x64-5.12.10.run。

安装过程中，务必勾选“Qt Creator”、“Qt 5.12.10”及全部子模块（尤其是Desktop GCC 64-bit和Qt Charts等常用组件），取消勾选无关语言包以节省空间。

方法二：安装预打包deb包（适用于ARM64或内网批量部署）

将qt5.12-arm文件夹拷贝至/home/kylin/桌面 → 终端进入该目录：cd /home/kylin/桌面/qt5.12-arm → 执行：sudo dpkg -i *.deb → 若提示依赖错误，立即补全：sudo apt install -f。

配置qmake路径与修复OpenGL渲染

第一步：启动Qt Creator → 工具 → 选项 → Kits → Qt Versions → 点击“Add” → 浏览到/opt/Qt5.12.10/5.12.10/gcc_64/bin/qmake（在线安装路径通常为/usr/lib/x86_64-linux-gnu/qt5/bin/qmake）。

第二步：回到Kits页面 → 点击“Desktop Qt 5.12.10 GCC 64bit” → 在“Qt version”下拉框中选择刚添加的qmake路径。

第三步：验证OpenGL支持——新建一个Qt Widgets Application项目 → 编译运行后若窗口黑屏或报错“Could not initialize OpenGL”，需执行：sudo apt install libgl1-mesa-glx libegl1-mesa，并重启Qt Creator。

这一步漏掉会导致所有基于QWidget或QQuick的界面程序无法显示，但编译仍成功，极易误判为代码问题。