qt creator启动失败主因是缺xcb图形依赖、路径/配置冲突或插件加载异常,需按顺序排查依赖安装(如libxcb-xinerama0等)、中文路径与常驻软件干扰、clang插件缺失或禁用,而非直接重装。

Qt Creator安装后打不开,大概率不是软件坏了,而是缺依赖、路径冲突或配置残留——先别重装,按顺序排查这三处。
启动时黑屏/无响应,终端报“Could not find the Qt platform plugin 'xcb'”
这是 Ubuntu / 麒麟等 Linux 发行版最常见的情况,本质是 Qt 缺少 X11 图形后端支持库。
- 运行
qtcreator -noload Welcome测试是否能绕过欢迎页插件启动;如果可以,说明问题出在插件加载阶段 - 立即安装基础图形依赖:
sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 - 若仍报错,检查
libgl1-mesa-dev是否已装(银河麒麟 V10 必装);没装就补上:sudo apt install libgl1-mesa-dev - 注意:Arm64 或 LoongArch 架构下,包名可能带架构前缀(如
libxcb-xinerama0:arm64),需显式指定
双击图标没反应,终端执行 qtcreator 也静默退出
通常不是崩溃,而是卡在初始化某项资源上,比如中文路径、显卡驱动或第三方软件冲突。
- 确认工程目录和 Qt Creator 配置路径不含中文字符——
~/.config/QtProject/QtCreator.ini所在路径也不能有中文 - 临时关闭有道词典、讯飞输入法、腾讯桌面整理等常驻进程,它们会 hook X11 或注入 Qt 线程导致死锁
- NVIDIA 显卡用户可尝试强制用集显运行:
__NV_PRIME_RENDER_OFFLOAD=0 qtcreator - 若怀疑配置损坏,直接重置:
mv ~/.config/QtProject/QtCreator.ini ~/.config/QtProject/QtCreator.ini.bak,再启动
启动后卡在欢迎页或界面空白,日志显示 “clangbackend无法启动”
这不是 Qt Creator 主体问题,而是 Clang Code Model 插件找不到对应二进制文件,常见于离线安装或精简版 Qt 套件。
- 检查 Qt 安装目录下是否存在
Tools/QtCreator/libexec/clangbackend(Linux/macOS)或Tools/QtCreator/lib/clang/bin/clangbackend.exe(Windows) - 若缺失,用 Qt 安装目录下的
MaintenanceTool重新勾选 “Clang Code Model” 组件并更新 - 不打算用 Clang 补全?可在
工具 → 选项 → C++ → Code Model中把 Backend 改为 “Built-in”,避免启动时加载失败 - 注意:某些国产系统(如龙芯 UOS)因 LLVM 版本冲突,即使装了 clangbackend 也会报
CommandLine Error: Option 'help-list' registered more than once,此时只能禁用该插件
银河麒麟 V10 上安装完 Qt Creator 启动失败
麒麟系统默认不预装 Qt 库和构建链,只装 qtcreator 包会导致“有壳无核”——IDE 能开,但无法新建项目、找不到 qmake。
- 必须先装编译基础:
sudo apt install build-essential cmake gdb libgl1-mesa-dev - 再决定 Qt 运行时来源:在线方式用
sudo apt install qt5-default qtbase5-dev;离线方式则需手动下载qt-opensource-linux-x64-5.12.10.run并运行安装 - 安装完 Qt 后,进 Qt Creator 的
工具 → 选项 → Kits → Qt Versions,点击“添加”,指向你安装的qmake路径(例如/opt/Qt5.12.10/5.12.10/gcc_64/bin/qmake) - 最后检查 Kit 是否自动关联成功;若未关联,手动在 Kits 页面选择刚添加的 Qt Version 和编译器
真正难搞的往往不是启动失败本身,而是错误信息被静默吞掉——务必在终端中运行 qtcreator,盯着 stdout/stderr 输出,比点图标靠谱十倍。另外,QtCreator.ini 里藏了不少隐性开关,比如禁用某个插件只需把对应 section 下的 Enabled=true 改成 false,比删文件更可控。











