推荐新手使用在线安装器安装qt5或qt6，需下载镜像站qt-unified-linux-x64-4.5.2-online.run，赋权运行后注册账号、勾选对应qt版本及desktop gcc_64组件和qt creator ide，完成安装并验证qmake版本与kit配置。
如果您希望在Ubuntu系统上搭建Qt开发环境以进行Linux桌面应用开发，则需根据目标Qt版本、安装方式及配套工具链选择合适路径。以下是多种可行的安装方法：
一、使用在线安装器安装Qt5或Qt6（推荐新手）
该方法通过Qt官方提供的图形化在线安装器完成，自动处理依赖、组件选择与环境注册，适合大多数桌面开发场景。
1、访问镜像站点下载最新版在线安装器，例如清华大学镜像：https://mirrors.tuna.tsinghua.edu.cn/qt/official_releases/online_installers/，选择类似 qt-unified-linux-x64-4.5.2-online.run 的文件。
2、在终端中赋予执行权限并运行：chmod +x qt-unified-linux-x64-4.5.2-online.run && ./qt-unified-linux-x64-4.5.2-online.run。
3、安装过程中需注册Qt账户（个人学习可使用任意邮箱），登录后跳过官方支持选项。
4、在“Custom Installation”界面，点击右上角 Archive 标签，筛选并勾选 Qt 5.15.2 或 Qt 6.5.3 组件；务必同时勾选对应版本的 Desktop gcc_64 编译套件及 Qt Creator IDE。
5、确认安装路径（如 /home/username/Qt），开始安装，等待进度条完成。
二、离线安装Qt5.15.2（适用于无网络或内网环境）
该方式使用预编译的离线安装包，无需联网验证，但需手动配置Kit与编译器绑定。
1、从归档地址下载离线包：https://download.qt.io/archive/qt/5.15/5.15.2/，获取 qt-opensource-linux-x64-5.15.2.run。
2、终端执行：chmod +x qt-opensource-linux-x64-5.15.2.run && ./qt-opensource-linux-x64-5.15.2.run。
3、跳过登录步骤（若提示），直接进入安装向导；指定安装路径（建议非/root目录），全部勾选组件（含 Qt 5.15.2、GCC 64-bit、Qt Creator）。
4、安装完成后，启动Qt Creator，在 Tools → Options → Kits → Compilers 中确认已识别系统GCC（路径通常为 /usr/bin/g++）。
5、在 Kits → Qt Versions 中点击“Add”，指向安装目录下的 /5.15.2/gcc_64/bin/qmake。
三、源码编译安装Qt4.8.7（适配老旧项目）
当维护遗留Qt4项目时，必须从源码构建，此过程可控性强但耗时长，且需预先满足X11开发依赖。
1、下载源码包：https://download.qt.io/archive/qt/4.8/4.8.6/qt-everywhere-opensource-src-4.8.6.tar.gz。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
2、解压后进入目录，执行配置命令：./configure -prefix /opt/Qt4.8.7 -opensource -confirm-license -no-opengl -no-sql-sqlite -no-webkit（禁用非必需模块以缩短编译时间）。
3、输入 o 选择开源版，再输入 yes 接受协议。
4、运行编译：make -j$(nproc)，预计耗时15–40分钟，取决于CPU核心数。
5、执行安装：sudo make install；随后将 /opt/Qt4.8.7/bin 加入PATH，并在Qt Creator中手动添加该qmake路径。
四、修复常见运行时错误
安装完成后新建项目编译失败，多由系统级依赖缺失导致，需逐项排查。
1、若报错 "Could not determine which 'make' command to run"，执行：sudo apt install build-essential。
2、若报错 "cannot find -lGL"，执行：sudo apt install libgl1-mesa-dev。
3、若报错 "QStandardPaths: XDG_RUNTIME_DIR not set"，在终端中临时设置：export XDG_RUNTIME_DIR=/tmp，或将其写入 ~/.profile。
4、若Qt Creator无法识别设备或调试器，检查 Tools → Options → Devices → Local PC 是否启用，并确认GDB路径为 /usr/bin/gdb。
五、验证安装结果
通过命令行与IDE双重校验安装完整性，确保开发链路可用。
1、终端输入：qmake -v，输出应包含对应Qt版本号及构建日期。
2、终端输入：which qmake，返回路径须指向所安装Qt版本的bin目录。
3、启动Qt Creator，新建 Qt Widgets Application 项目，选择已配置好的Kit，点击运行按钮，观察窗口是否正常弹出。
4、在项目构建目录下查找生成的可执行文件，执行：./build-untitled-Desktop_Qt_5_15_2_GCC_64bit-Debug/untitled，确认无动态库缺失错误。
