Ubuntu安装Qt环境教程Linux开发入门指南

本文是一份面向Linux新手的Ubuntu系统Qt开发环境搭建实战指南，详细介绍了四种主流安装方式——推荐新手使用的图形化在线安装器（Qt5/Qt6）、适用于无网络环境的离线安装、针对老旧项目的Qt4.8.7源码编译，以及关键的常见错误修复与安装验证步骤，手把手教你从下载、授权、组件选择、Kit配置到成功运行首个桌面应用，覆盖从入门到排障的完整开发链路，助你零基础快速迈入Linux Qt开发大门。

如果您希望在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。

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，确认无动态库缺失错误。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~