用APT安装qtcreator仅含IDE本体,缺失Qt库、qmake及构建工具链,导致“No valid kits found”错误;必须通过官方.run包安装才能获得完整开发环境。

直接用系统包管理器装最省事,但默认版本通常老旧、缺组件;想用新版或完整功能,必须走官方 qt-opensource-linux-x64-*.run 安装包 —— 这是唯一能同时拿到 Qt 库、qmake、Qt Creator IDE 和调试器的方案。
用 apt install qtcreator 为什么不行?
Ubuntu/Debian 的仓库里 qtcreator 包只含 IDE 本体,不带 Qt 运行时和构建工具链。启动后新建项目会立刻报错:Kit is not valid: No valid kits found,因为找不到 qmake 或对应 Qt 版本。
- 它依赖系统级的
qt5-default,但该包只提供基础模块(qtbase5-dev),缺qtdeclarative5-dev、qttools5-dev等常用组件 - 无法选择 Qt 版本(比如你要用 5.15.2 而非系统默认的 5.12.x)
- 交叉编译、Android 支持、文档和示例全部缺失
运行官方 .run 安装包前必须做的三件事
跳过这步,安装中途可能卡死、权限失败,或装完打不开界面。
Linux 性能分析与调优专家,覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景:系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 确保已安装图形依赖:
sudo apt install libxcb-xinerama0 libxcb-xkb-dev libxcb-cursor-dev libxkbcommon-x11-1(尤其 Ubuntu 22.04+ 和国产发行版常见缺失) - 断网再运行安装程序 —— 否则 Qt 账户登录页强制弹出,
Skip按钮常被禁用;断网后点 Next 直接进组件选择页 - 用
sudo运行,否则默认装到家目录,后续配置 Kits 时路径混乱;推荐命令:sudo ./qt-opensource-linux-x64-5.15.2.run
安装时组件勾选别贪多,但也不能太省
全选看似省心,实际占 10GB+ 空间,且多数人用不到 Android、WebAssembly 或源码。关键是要保留构建能力。
- 必选:
Qt 5.15.2(或你选的版本)、Qt Creator 11.0.x、Tools > CMake、Tools > Ninja - 可选但强烈建议:
Qt Charts、Qt SVG、Qt Tools > Qt Linguist(国际化必备) - 明确可删:
Android x86_64、Android ARM64、Sources、Qt Script (Deprecated)
装完启动报 -lGL 错误?不是没装好,是缺 OpenGL 链接库
新建空项目点击运行,报错:error: cannot find -lGL 或 libGL.so.1: cannot open shared object file —— 这和 Qt 安装无关,是系统没装 Mesa 或驱动未启用。
- 先查有没有:
find /usr/lib/x86_64-linux-gnu -name "libGL.so*",若无结果,说明确实缺失 - Ubuntu/Debian 系:
sudo apt install libgl1-mesa-dev libegl1-mesa-dev - 麒麟、UOS 等国产系统:需额外装
libgl1和对应显卡固件(如nvidia-driver-535),否则即使装了库也加载失败 - 虚拟机用户注意:VMware/VirtualBox 必须开启 3D 加速,且 Guest Additions / 增强功能已安装
真正容易被忽略的是 Kits 配置 —— 安装完 Qt Creator 只是第一步,Options > Build & Run > Kits 里要手动把 Qt version 和 Compiler 关联起来,否则新建项目仍提示 kit invalid。这个步骤没有向导,全靠手动点选匹配,而且改完要重启 Qt Creator 才生效。

















