刘炳琦1. 动手前先想清楚：装哪个版本、走哪条安装路线
关于 Ubuntu 24.04 安装 Qt，网上的教程不少，但版本各不相同。有人装的是 Qt 6.x，有人还在用 Qt 5.15.2，有人走官方在线安装器，有人用离线包，评论区里还经常看到 platform plugin xcb 报错、中文输入法切不出来、qmake 找不到命令这些追问。我这次就把自己在新系统上从零到可用的一套流程整理出来，从版本选择、依赖准备到 Qt Creator 配置、常见坑排查一次性讲清楚。无论你是刚入门的 Qt 新手，还是给实验室或者公司机器批量装环境的同学，这篇都可以直接照着抄。
先说结论：如果你准备在新项目上投入，建议直接装 Qt 6.5 LTS 或者更新的 6.x 版本；如果你要维护老项目、公司内部还依赖 qmake 构建和 Qt 5 模块，那 Qt 5.15.2 依然值得保留。很多工业软件、嵌入式上位机工程到现在还是 Qt 5.15.2 起步，这不是保守，而是业务决定的。所以这里我建议不是二选一，而是看你的实际使用场景，甚至可以两个版本共存。
1.1 Qt 6.x 和 Qt 5.15.2 怎么选
Qt 6.x 从架构上做了不少调整，模块拆分更细，CMake 已经成了官方首选的构建方式，QML 和 Quick 的性能提升也很明显。如果是从头开始做新应用，用 Qt 6 可以省去以后迁移的成本。特别是 Ubuntu 24.04 这种比较新的系统，装 Qt 6.5 以上的任何版本，系统库兼容性都相对顺畅，不容易遇到“C++ ABI 不匹配”这类奇怪问题。
Qt 5.15.2 是 Qt 5 系列的最后一个 LTS 版本，注意 5.15.3 之后是商业维护，开源社区基本停留在 5.15.2。很多老代码、老教程、老依赖库都围绕它展开，比如 QCustomPlot 这类老牌绘图库，和 Qt 5 的组合在工业项目里用得非常稳。另外，不少第三方硬件厂商提供的 SDK 仍然只针对 Qt 5 编译，所以如果你手里有厂家提供的库文件，最好先确认它们是基于 Qt 5 还是 Qt 6 编译的。
两个版本能不能共存？完全可以。Qt 官方安装器支持把多个版本装在同一套目录下，比如 ~/Qt/6.5.3/gcc_64 和 ~/Qt/5.15.2/gcc_64，Qt Creator 会自动扫描识别。实际使用中无非就是切换构建套件，我后面会详细说。
1.2 三种安装方式怎么选：在线安装器、离线包、apt
安装 Qt 常见路径有三条：
- 官方在线安装器：这是最推荐的常规方案。下载一个几十 MB 的启动器，运行后按提示登录 Qt 账号、勾选组件，安装器会从官方源把需要的内容拉下来。好处是组件可选、版本可选、后续还能通过维护工具增删组件。
- 离线安装包：适合内网环境、批量部署、网络不稳定或者需要反复安装的场景。官方对部分老版本提供
.run离线包，体积大，下载一次后面就省心了。 - apt 直接安装：
sudo apt install qtbase5-dev qt6-base-dev这类方式适合只需要 Qt 运行库、不想要完整 IDE 的场景。Ubuntu 仓库里打包的 Qt 版本通常落后于官方最新版，但胜在简单、和系统包管理集成良好，后续升级依赖也方便。
这三种方式不冲突。我自己常干的组合是：用官方在线安装器装 Qt 6 和 Qt Creator，再用 apt 补系统编译依赖和运行库，双保险。
1.3 先把编译链和依赖补齐
很多人安装 Qt 时只急着下载安装包，结果装完之后编译第一个 Demo 就报错，不是缺 g++ 就是找不到 OpenGL 头文件。这里建议先把基础编译工具和 Qt 运行时依赖装好，一次性到位：
bash复制sudo apt update
sudo apt install build-essential cmake ninja-build gdb
sudo apt install libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev
build-essential 里包含了 gcc、g++ 和 make，这是编译 C++ 项目的最小集合。libgl1-mesa-dev 和 libglu1-mesa-dev 是 OpenGL 开发库，Qt Widgets 和 Qt Quick 的程序基本都依赖 OpenGL 相关模块，缺了这些头文件，编译时会出现 fatal error: GL/gl.h: No such file or directory，尤其 Qt 6 下这个报错特别常见。
除此之外，Qt 6.5 之后的 Linux 版本对 libxcb-cursor0 有硬依赖，缺失时程序运行会直接报 platform plugin 加载失败。建议一并用下面这条命令装掉：
bash复制sudo apt install libxcb-cursor0 libxkbcommon-x11-0 libxkbcommon0 \
libxcb-icccm4 libxcb-keysyms1 libxcb-shape0 libxcb-xfixes0 \
libxcb-render-util0 libxcb-xinerama0
这些库看着多，实际上体积都不大，几分钟就能装完。装好之后，再进入 Qt 本体安装，后面的坑会少很多。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 在线安装器完整实操：下载、授权、组件勾选
这一节讲官方在线安装器最完整的流程，跟着一步步操作就行。
2.1 去官网下载页拿安装器
打开 Qt 官方下载页，进入开源版本下载入口，找到 Qt Online Installer for Linux。文件名一般是 qt-online-installer-linux-x64-x.x.x.run，x86_64 架构的 Ubuntu 24.04 桌面版直接选这个就行，ARM 设备另说。
这里有个细节：浏览器下载完成后，安装器默认没有执行权限。在终端里进入下载目录执行：
bash复制chmod +x