必须用官方在线安装器——包管理器装的Qt6缺模块、没qmake、不带调试符号，编译时大概率报Could not find qmake spec或module "QtQuick" is not installed。
直接装 qt6-base-dev 和 qtcreator 就能跑最基础的 GUI 项目，但想用 Qt Quick、CMake 构建或跨版本开发，必须用官方在线安装器（Online Installer）——包管理器装的 Qt6 缺模块、没 qmake、不带调试符号，编译时大概率报 Could not find qmake spec 或 module "QtQuick" is not installed。
用 apt/dnf 安装只能跑 demo，别指望它做正式开发
Debian/Ubuntu 上执行 sudo apt install qt6-base-dev qt6-declarative-dev qtcreator 看似省事，实际会踩三个坑：
-
qt6-base-dev不含qmake，CMakeLists.txt 里写find_package(Qt6 REQUIRED COMPONENTS Core Widgets)会失败，因为系统找不到Qt6Config.cmake（它被装在/usr/lib/x86_64-linux-gnu/cmake/Qt6，但路径没进CMAKE_PREFIX_PATH） -
qt6-declarative-dev缺QtQuick.Controls的完整样式资源，import QtQuick.Controls能通过，运行时弹出QML module not found - Qt Creator 启动后 Kit 自动检测不到可用 Qt 版本，手动指定
/usr/lib/x86_64-linux-gnu/qt6/bin/qmake会提示 “qmake version mismatch”，因为包管理器装的是 Qt 6.7.x，而 Creator 内置的 Qt 版本检测逻辑只认 Online Installer 装的布局
Online Installer 是唯一能保证开箱即用的方式
官网下载 qt-unified-linux-x64-online.run（2026 年最新版），运行前必须做两件事：
- 确保有 Qt 账号（免费注册，跳过登录页会卡在组件选择界面）
- 不要用
sudo运行安装器——它默认装到~/Qt，用 root 装进/opt/Qt会导致权限混乱，后续qtcreator.sh启动时报cannot open shared object file: libQt6Core.so.6 - 组件勾选必须包含：
Qt 6.7.2 (GCC 13.2.0 64-bit)、Qt Creator 14.0.2、Tools > CMake 3.28.3（别选 Ninja，Qt Creator 对 Ninja 的 Kit 支持不稳定）
装完不用手动配环境变量，~/Qt/Tools/QtCreator/bin/qtcreator.sh 直接启动，Kit 会自动识别 ~/Qt/6.7.2/gcc_64 下的所有工具链。
验证安装是否真可用：跑一个最小 Qt Quick 项目
别信 “Hello World” 控制台程序——那只是验证了 C++ 编译器。真正检验 Qt 安装质量的是 QML 渲染：
- 新建项目选
Qt Quick Application - Empty，模板会自动生成main.qml和main.cpp - 构建套件（Kit）必须选中
Desktop Qt 6.7.2 GCC 64bit，不能选System GCC - 如果运行时报
Could not create platform OpenGL context，不是 Qt 没装好，而是显卡驱动问题：Ubuntu 24.04 默认用 Mesa，需额外装sudo apt install mesa-utils libgl1-mesa-dri；NVIDIA 用户要确认nvidia-driver-535已加载
真正麻烦的从来不是安装步骤本身，而是 Qt Creator 的 Kit 配置逻辑和系统 OpenGL 栈的耦合——装完发现 QML 窗口是空白灰块，90% 情况下不是 Qt 问题，是 Mesa/GLX/EGL 链路断在某一层。
