不妧先说结论：这篇文章面向的是“要在 Ubuntu 24.04 上把 Qt 开发环境从零搭起来，并且真的能跑起来”的人。Qt 版本、安装器、系统依赖、环境变量、输入法、平台插件这几个坑，我会按实际操作顺序一个个说清楚。你自己装的时候肯定会遇到其中几个，照着这篇走能省下起码一个下午的折腾时间。
我在 Ubuntu 24.04 上装 Qt 不止一次，从 Qt 5.15.2 到 Qt 6.5 LTS 都跑过。24.04 和早先的 22.04 或者 20.04 有个明显的差异：系统默认的 GCC 版本、OpenGL 相关库、Wayland/X11 的运行时库都不一样了。很多老教程拿到 24.04 上会直接报错，比如缺 libxcb-cursor0、Qt Creator 打不开、Qt 程序 “no platform plugin could be initialized” 等。这些问题本质上不是你代码的问题，而是环境没配齐。所以这篇文章不只要讲“怎么点下一步”，更要讲“为什么这一步必须做”。
如果你是纯新手，第一次在 Linux 上装 Qt，也不用怕。我会把每一步都拆开讲，包括安装包的下载方式、组件怎么勾、环境变量怎么配、第一个测试程序怎么写。如果你想在自己的 Qt 工程里用 QCustomPlot、QChart、串口这些功能，后面也有专门的依赖说明。
1. 安装前的思路与选型考量
1.1 在线安装器还是离线安装包？
Qt 官方提供两类安装方式：在线安装器（online installer）和离线安装包（offline installer）。在线安装器最大的好处是体积小，启动后按需下载你想要的大版本、模块和编译套件；坏处是如果你网络不稳，中途容易断，而且 Qt 官网的下载服务器在国内经常很慢。离线安装包则省事，下载后直接传到任意一台机器上就能装，适合离线环境或者公司内网批量部署，但缺点是单个包体积很大，比如 Qt 6.5.3 的离线包普遍在 1GB 以上。
我的建议是：如果你网络条件一般，优先尝试在线安装器 + 国内开源软件镜像站加速组合。具体怎么加速后面会说。如果你要装的是 Qt 5.15.2 这种已经进入“Archive”区域的版本，在线安装器勾选时需要先登录账号，并且要把安装源切到 archive 仓库，新手很容易卡在这一步。这时候用离线包反而更省心。
还有一点要提前确认：Ubuntu 24.04 自带的 apt 源里其实也有 Qt。直接 sudo apt install qt6-base-dev 就能装一套 Qt 6 开发库，但那是系统库版本，适合跑依赖 Qt 的桌面应用，不适合做完整 Qt 开发调试，因为你想装 Qt Creator、Qt Charts、Qt Multimedia 等一套全家桶就相对麻烦。所以本文默认用官方 SDK 安装器，把 Qt 装到 /opt/Qt 或 ~/Qt 目录，和系统 apt 库隔离。这样做的好处是不同项目可以用不同 Qt 版本，互不污染，风险是后续编译时要注意 PATH 和 CMAKE_PREFIX_PATH 指向正确。
1.2 版本选择：Qt 5.15.2 还是 Qt 6.x？
很多现在还在用 Qt 5.15.2 的项目，大多是从以前的老工程升级过来的。5.15.2 是 Qt 5 系列里最重要的 LTS 版本之一，兼容性好，大量开源库（比如 QCustomPlot、QSerialPort、QCharts）在 5.15.2 下很稳定，所以工业界存量很大。如果你没特殊要求，我建议不要盲目追新，先看你的工程依赖哪些模块。
Ubuntu 24.04 上同时装 Qt 5.15.2 和 Qt 6.5 LTS 是完全可以的，关键是安装目录不同、qmake/cmake 的路径不能搞混。实际开发中，同一个 Qt Creator 可以注册多个 Qt 版本和多个构建套件（Kit），这就是 Qt 官方推荐的多版本共存方式。我见过有的团队为了省事只装一个版本，结果项目升级时被 Qt 6 的 API 变化打了个措手不及。多装一个 LTS 备用，成本只是磁盘空间，收益却很大。
1.3 安装目录规划
Qt 官方安装器默认会装到 ~/Qt，也就是当前用户主目录下。装完之后路径大概是 ~/Qt/6.5.3/gcc_64，这里的 gcc_64 就是 Linux x86_64 桌面版的 Qt 库目录。个人开发用这个路径没问题，权限也简单。但如果你在团队服务器上，或者希望所有人共用一套环境，可以改成 /opt/Qt，安装时直接填路径 /opt/Qt 即可，前提是当前用户对 /opt 有写权限，或者先 sudo chown $USER /opt/Qt 创建好目录再装。
我自己更偏向装到 /opt/Qt。一是好找，二是后续配 CMake、配 CI、写文档都方便，路径稳定不变。而且如果不小心装坏了，删掉重装不影响主目录里一堆项目文件。记住一点：Qt 目录一旦装好，不要随便移动位置，因为安装器写的路径、.conf 配置文件、Qt Creator 自动检测的路径全是绝对路径，挪了目录后一堆东西会“失联”。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心安装流程与关键配置
2.1 下载安装器与镜像加速
先打开 Qt 官方下载页面，找到 “Download for open source users” 下的在线安装器链接，下载 Linux x64 后缀为 .run 的文件。当前在线安装器的命名形如 qt-online-installer-linux-x64-4.7.0.run。下载完成后，在终端里执行：
bash复制chmod +x qt-online-installer-linux-x64-4.7.0.run
./qt-online-installer-linux-x64-4.7.0.run
如果这一步你卡在下载速度上，有两个缓解手段。第一，用镜像站直接下载在线安装器或离线包；第二，在安装器登录后的设置里自定义 Qt 软件仓库，改成开源镜像站的 Qt 仓库地址。注意，改了仓库地址之后，版本列表的刷新速度和后续模块的下载速度都会有明显提升。
提示：如果你使用 Ubuntu 24.04 桌版，默认 Wayland 会话下运行安装器出现界面花屏、缺字、窗口空白，可以在运行安装器前先指定软