在开始执行apt install命令之前,建议先确认两个关键前提:您的系统架构是x86_64还是ARM64?网络环境是连接外网还是完全隔离?如果判断失误,可能会导致安装失败,或者启动时出现“无法找到qmake”或“OpenGL初始化失败”等错误。联网环境下仅安装IDE时,您需要手动配置qmake路径;而断网环境下则必须使用与架构匹配的离线安装包——x86_64架构推荐.run格式,ARM64架构则使用.deb格式,并且需要完整安装Qt库及Qt Creator。最后,在Kit设置中正确配置qmake路径,验证构建通过才算部署完成。

在银河麒麟V10-SP1操作系统中安装Qt Creator,最重要的第一步是明确系统架构(x86_64或ARM64)以及网络状态(联网或断网)。为何如此关键?因为官方软件源中的Qt Creator并不包含Qt运行时环境,尤其是ARM64架构下,默认源中缺少对应的二进制包。如果直接执行apt install,启动后很可能提示“无法找到qmake”或OpenGL初始化失败。因此,请务必先确认这些基础信息,再动手安装。
联网环境快速安装Qt Creator(仅IDE,不含Qt库)
此方案适用于x86_64架构且具备稳定外网连接的设备,适合仅需轻量级IDE进行代码编辑或远程编译的场景——简而言之,您不希望安装完整的Qt库,只想要一个便捷的代码编辑器。
第一步,更新软件源索引并安装基础工具链:
sudo apt update && sudo apt install -y build-essential gdb cmake libgl1-mesa-dev
第二步,安装Qt Creator本体:
sudo apt install -y qtcreator
第三步,也是最容易忽略的一步:首次启动后必须手动配置Qt版本路径,否则新建项目或编译时IDE会无法自动识别系统中可能已存在的Qt安装目录。您需要手动告知IDE去哪里查找qmake。
断网环境部署完整Qt开发套件(包含Qt 5.12.10及Qt Creator)
内网隔离、军工涉密、离线部署等场景中,依赖缺失、架构错配、OpenGL降级是常见的陷阱。以下方案专为避开这些问题设计,直接为您提供完整可用的开发环境。
方法一:x86_64架构离线安装
① 下载官方离线安装包 qt-opensource-linux-x64-5.12.10.run(MD5校验值必须为 b9b19b6e2dac20a9f9a20d5f8e6d8a3c,请确保版本无误)。
② 将文件放置到用户主目录,执行 chmod a+x qt-opensource-linux-x64-5.12.10.run。
③ 关键前提:断开所有网络连接。 这一步很多人忽略——联网状态下运行安装程序会强制跳转Qt账户注册页,导致流程卡死。断网才能顺利走完图形向导。
④ 运行 ./qt-opensource-linux-x64-5.12.10.run,在图形向导中选择安装路径为 ~/Qt5.12.10(避免使用/opt或/usr,以防权限问题),然后勾选全部组件——包括Qt Creator、Qt 5.12.10、MinGW或GCC工具链。
方法二:ARM64架构离线安装
从可信镜像源获取适配的 qt5.12-arm.deb 合集,拷贝到 /home/kylin/qt5.12-arm/桌面。然后执行 sudo dpkg -i *.deb。如果提示依赖错误,使用 sudo apt --fix-broken install 自动补全即可。
安装后必做的三件事
第一件事:打开Qt Creator → 工具 → 选项 → Kits → Qt Versions → 点击“添加”,浏览到 ~/Qt5.12.10/5.12.10/gcc_64/bin/qmake(适用于x86_64架构),ARM64架构的实际路径可能是 gcc_64 或 linux_armv7_g++,请根据系统实际目录选择。
第二件事:回到Kits页面,检查“Desktop Qt 5.12.10 GCC 64bit”是否自动关联成功。如果未出现,手动点击“自动检测”按钮,它会重新扫描。
第三件事:创建一个空项目测试编译。文件 → 新建文件或项目 → Application → Qt Widgets Application → 一路下一步 → 点击左下角“构建”按钮,观察编译输出栏。出现“Build finished”才说明一切正常,可以正式投入开发工作。
