qt creator安装失败需先定位下载、校验或写入环节卡点，换清华镜像、启用调试日志、补全qt.conf、装齐系统依赖库，并检查磁盘空间与安装路径权限。
Qt Creator安装失败不是“装不上”，而是安装程序在下载、校验或写入阶段卡在某个具体环节。直接重试或换镜像往往治标不治本，得先定位是哪一环断了。
安装中途反复弹出“文件下载失败”
在线安装器（qt-online-installer）本质是个下载器+解包器，它会从 Qt 官方 CDN 分批拉取组件包。网络抖动、DNS污染或国内防火墙干扰都会导致单个文件下载超时或校验失败。
- 不要连续点“重试”几十次——安装器的重试逻辑不智能，容易陷入死循环
- 改用国内镜像源：下载地址替换为
https://mirrors.tuna.tsinghua.edu.cn/qt/online/installer/对应版本的离线安装包（如qt-unified-windows-x64-4.8.2-online.exe） - 若必须用在线安装器，启动前先执行：
set QT_DEBUG_PLUGINS=1（Windows）或export QT_DEBUG_PLUGINS=1（macOS/Linux），可让日志输出更详细，定位具体哪个 URL 卡住
安装完成但 Qt Creator 启动报“Qt 没有被正确安装”
这通常发生在你手动编译过 Qt（比如从源码 configure && make && make install），但没生成或放置 qt.conf 文件。Qt Creator 依赖该文件确认 Qt 安装根路径，否则认为“目录结构不完整”。
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 进入你编译好的 Qt 的
bin/目录（例如D:\Qt\5.15.2\msvc2019_64\bin\） - 新建纯文本文件，命名为
qt.conf，内容仅两行：[Paths] Prefix=..
- 不要用记事本另存为 UTF-8-BOM，用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM 格式
- 重启 Qt Creator，再进
工具 → 选项 → Kits → Qt Versions手动添加该qmake.exe路径
Linux/macOS 下安装后无法启动或构建失败
Qt Creator 是 Qt 写的 GUI 程序，它本身对系统图形栈、X11/Wayland 或 macOS SDK 有隐式依赖，不是装完就能跑。
- Ubuntu/Debian 类系统：必须装全
libxcb*和 OpenGL 开发库，缺一个就白屏或闪退，命令是：sudo apt install libxcb-xinerama0 libxcb-xinput0 libxcb-xkb-dev libxkbcommon-x11-0 - macOS M 系列芯片：必须装 Xcode 命令行工具（
xcode-select --install），且不能只装 CLT，要完整装 Xcode（App Store 下载），否则clang++缺少 SDK 路径，构建时报error: no such sysroot - 银河麒麟等国产系统：需确认是否已装
build-essential和libgl1-mesa-dev，并检查/usr/lib/x86_64-linux-gnu/qt5/下是否存在libQt5Core.so等基础库
最常被忽略的是：Qt Creator 安装器不验证磁盘空间和权限。哪怕只剩 2GB 空间，它也会开始下载，直到写入时静默失败；在非管理员账户下安装到 C:\Program Files\，也会因权限不足导致部分组件注册失败。动手前先看一眼剩余空间和安装路径权限。
