Qt教程 — 1.1 Linux下安装Qt

Qt 是跨平台的 C++ 图形界面框架，Linux 下安装通常有官方 run 包和包管理器两条路。这篇从下载、安装到装依赖、验证，把 Ubuntu 环境下 Qt 5.12 的完整流程走一遍，并说明三种下载方式的适用情况。

一、下载 Qt

1.1 官方下载

到 Qt 官网找对应版本，本文用的版本是 qt-opensource-linux-x64-5.12.12，官方下载入口在 https://download.qt.io/archive/qt/。

1.2 网盘下载

官方源偶尔慢，也可以先下到网盘再拉到虚拟机，提取码之类的信息一般在发布页会写明。

1.3 直接在 Linux 虚拟机终端下载

把下载链接复制进 Ubuntu 虚拟机终端，用 wget 拉：

wget https://download.qt.io/archive/qt/5.12/5.12.1/qt-opensource-linux-x64-5.12.12.run

注意核对文件名：官方 5.12.12 的 run 包通常就是上面这个路径（5.12 目录下的 5.12.1 子目录），拉完用 ls -lh 看一眼文件大小，明显偏小说明没下完整，删掉重下。

二、安装 Qt

把下载好的 run 文件放进任意目录，在该目录下打开终端。先赋予可执行权限，然后用 sudo 运行（这样会装到 /opt 下）：

chmod +x qt-opensource-linux-x64-5.12.12.run
sudo ./qt-opensource-linux-x64-5.12.12.run

执行后弹出 Qt 安装向导，按引导走完几步：

1. 登录 Qt 账号。没有的话点 Signup 自行注册一个，设好账号密码后点 Next；也可以直接去官网注册。
2. 邮箱会收到验证信息，按提示继续填写、设置好点 Next。
3. 开源版 Qt 遵循 GPLv2、GPLv3 或 LGPLv3 协议。勾选同意使用开源版本 Qt，填写公司/个人名字，点 Next。
4. 进入 Qt 欢迎安装界面，点 Next。
5. 默认安装目录，点 Next。
6. 选择安装组件，点 Next。
7. 同意服务条款，点 Next。
8. 开始安装。

装完在 /opt 下就能看到 Qt 的目录结构。

三、安装编译依赖

Linux 下跑 Qt 程序还需要基础编译工具链和图形相关开发库，一条命令补齐：

sudo apt-get install gcc g++
sudo apt-get install build-essential
sudo apt-get install libgl1-mesa-dev
sudo apt-get install libglu1-mesa-dev freeglut3-dev

这几组分别解决：C/C++ 编译器、构建工具集（含 make）、OpenGL 运行与开发头文件、GLU 与 freeglut。缺任何一个，新建项目时都会在编译阶段报 fatal error: GL/gl.h: No such file or directory 之类的错误。

四、验证安装

两种方式都行：

• 图形界面：在左下角应用商店/应用程序中心找到 Qt Creator，点开即可。
• 命令行：直接输入 qtcreator（注意是小写的 q、t、c 连写），能起界面就说明装好了。

再顺手新建个最简 Qt Widgets 项目编译一次，比只看图标更可靠——能编译链接、能运行，才算环境打通。

五、常见问题

• 双击 run 包没反应：多半是忘了 chmod +x，或者是在没有图形桌面的精简版系统里跑。
• 最小化安装后缺组件：回到安装向导可以追加组件（Qt Creator、对应 Qt 版本、编译器插件如 GCC / MinGW）。
• Qt Creator 能开但编译报错：回头检查第三步的依赖库，尤其是 build-essential 和 mesa 相关包。
• 多版本共存：不会影响，不同 Qt 版本各装各的目录；用 Qt Creator 的「工具 → 选项 → 构建套件」切换即可。

qidao123.com企服评测-应用市场 编辑提示