Qt Creator 不能仅用 apt install qtcreator 直接使用,因其仅安装旧版独立前端,缺失 Qt SDK、编译器(g++/qmake)、平台插件依赖(如 libxcb-cursor0),导致启动崩溃或报 xcb 插件加载失败;必须通过官方在线安装器(qt-unified)完整部署,并手动补全依赖与配置。

Qt Creator在Ubuntu上不能直接用apt install qtcreator装完就开用——装的是老版本(比如Qt 5.15或更早),且缺编译器、缺Qt SDK、缺xcb平台插件依赖,启动后大概率黑屏、闪退或报Could not load platform plugin "xcb"。
为什么不能只用apt装
Ubuntu官方源里的qtcreator包是独立打包的,不带Qt SDK,也不绑定qmake或cmake工具链;它默认找系统里已有的qt5-default,但Ubuntu 24.04默认没装Qt 6,也没装build-essential和图形平台依赖。结果就是:图标能点开,界面一加载就崩溃。
-
apt install qtcreator装的是Qt Creator 12.x,但底层Qt库版本错配 - 缺失
libxcb-cursor0、libxcb-xinerama0等X11平台插件依赖,导致libqxcb.so加载失败 - 没有预装
g++、qmake、cmake,新建项目后立刻提示“no valid kit”
必须用官方在线安装器(qt-unified)
Qt官网提供的qt-unified-linux-x64-*.run才是完整方案,它能一次性拉取Qt SDK、Qt Creator、工具链和对应平台插件,版本对齐有保障。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 下载地址优先用镜像:
http://mirrors.ustc.edu.cn/qtproject/archive/online_installers/(比官网快) - 文件名类似
qt-unified-linux-x64-4.10.0-online.run,不是qt-creator-*.run - 执行前必须加可执行权限:
chmod +x qt-unified-linux-x64-4.10.0-online.run - 建议非root运行(避免写入
/opt需要sudo),安装路径选~/Qt更安全
装完必做的三件事
安装器走完流程后,Qt Creator可能仍无法启动或构建项目——因为Linux下Qt的平台插件依赖是显式链接的,不自动补全。
- 检查xcb依赖是否齐全:进
~/Qt/Tools/QtCreator/lib/Qt/plugins/platforms,运行ldd libqxcb.so | grep "not found",常见缺失项包括libxcb-cursor.so.0、libxcb-xinerama.so.0 - 按提示装依赖:
sudo apt install libxcb-cursor0 libxcb-xinerama0 libxcb-xkb1 libxkbcommon-x11-0 - 确认编译器可用:在Qt Creator里打开
Options → Build & Run → Compilers,确保gcc和g++路径正确(通常是/usr/bin/gcc);再切到Qt Versions,手动添加~/Qt/6.9.2/gcc_64/bin/qmake(路径按你实际安装的Qt版本调整)
启动时闪退或白屏怎么办
最常见原因是Wayland会话下xcb插件初始化失败——Ubuntu 24.04默认用Wayland,但Qt Creator 12+对Wayland支持仍不稳定。
- 临时解决:终端里先执行
export QT_QPA_PLATFORM=xcb,再运行~/Qt/Tools/QtCreator/bin/qtcreator - 永久生效:把
export QT_QPA_PLATFORM=xcb加到~/.bashrc末尾,然后source ~/.bashrc - 如果连
qtcreator命令都找不到,说明PATH没设,别硬记路径,直接去~/Qt/Tools/QtCreator/bin/下双击执行或用绝对路径调用
真正卡住的地方不在安装步骤本身,而在“Qt Creator能否找到qmake、能否加载xcb、能否在当前会话类型(X11/Wayland)下渲染”。这三个点任何一个断掉,都会表现为“图标点了没反应”或“窗口一闪就消失”。

















