Linux 安装 Qt开源版 （环境配置及常见问题）

引入

哪里可以下载官方的 Qt 开源版？

• 参考 步骤一 相关内容

linux 中 .run 运行没有反应？

• 参考 步骤二 相关内容

如何安装旧版本的开源 Qt，现在的开源程序找不到旧版本的?

• 参考 步骤三 相关内容

如何管理已安装的 Qt，增加或卸载？

• 参考 步骤四 相关内容

如何打开已安装的 Qt？

• 参考 步骤五 相关内容

如何验证 Qt 安装成功了？

• 参考 步骤六 相关内容

P.s. ：右侧有本文的目录可以快速跳转

前置步骤（已安装的请忽略）

推荐优先安装 g++（sudo su // 以 root 用户运行）

apt install libgl1-mesa-dev
apt install g++

在输入 root 密码（一般为系统初始账户的密码）后，待终端提示您希望继续执行吗？ [Y/n] ，输入 Y，回车等待安装即可

步骤一

访问 Qt 官网 https://www.qt.io/

点击界面右上角的 “Download. Try.” 跳转到下载页

此时点击 “Explore Qt Community Edition” （右边的第一个框跳转）

跳转至如下界面，向下滚动，或直接搜索 “Download the Qt Online Installer” 快速跳转（单机红箭头指向的按钮下载即可）

点击跳转后，选择操作系统版本，在此演示选择 Linux x64

步骤二

找到下载的 .run 文件，命令行或者右键配置一下权限为 “可执行文件”，打开即可。( 命令在当前文件夹，终端命令输入 sudo chmod -R 777 <文件名包括后缀，一般可视化界面F2，全选即可> )

小提示

国内下载 Qt 有概率遇到网络波动导致下载速度缓慢甚至下载失败，我们可以尝试使用镜像站点来加速我们的下载（--mirror https://mirrors.cloud.tencent.com/qt 就是实现加速的效果）

./qt-online-installer-linux-x64-4.10.0.run --mirror https://mirrors.cloud.tencent.com/qt
//注意替换成相应的版本号

步骤三

输入账户密码，没用的注册一个

单击下一步，仅勾选自定义安装（此处演示安装 Qt5.15.2，其他版本任然适用）

下一步，我们发现现在的安装程序方框标注的地方并没有显示旧版的 Qt，此时点击箭头指向的下拉框，勾选 “Archive”, 即可显示所有版本。

等待历史归档加载完毕，即可看到旧版 Qt。（我们心心念念的旧版 Qt 出现啦）

此处演示安装 Qt5.15.2，其他版本任然适用，自行添加需要的模块，点击下一步安装即可。

勾选同意，下一步

清单确认无误后点击安装

安装进行时，由于网络环境，通常安装需要 1-3 小时不等，耐心等待即可（平均两个小时）。

出现如下界面即安装完毕，单击 “下一步”

此处按需勾选即可（这些选项只是一些快捷方式，对软件后续使用没有任何影响）

步骤四

卸载当前安装的 Qt 只需要在启动器（开始菜单）搜索 “Qt Maintenance Tool” （全局搜索更快）

打开后会出现如下界面（若只需要卸载，请勾选 “仅卸载”）并点击下一步，确认即可

如果需要新增、移除、更新组件，输入账号密码，单击下一步。

步骤五

打开 Qt（全局搜索 “Qt”，找到 “Qt Creator”），双击打开即可

稍等片刻出现如下界面

步骤六

在此仅提供简易的检验方法

打开 Qt Creator 创建项目，选择如下所示的创建

创建完成后，耐心等待一段时间，没有警告，直接点击 run，运行即可。如正常编译则安装成功（部分 SDK 需要手动配置）

常见问题解决方案

如果底部问题提示如下，请重新完成前置步骤。

完成前置步骤后，在选项卡中选择编辑，单击 “Preferences” (即首选项)

选择相应的构建套件，向下滚动

来回切换一下 g++（就是切一下，点击应用即可）

此时编辑器中的报错就消失啦！

P.s. ：如果在运行编译的过程中，遇到红色的警告，但不影响程序，可忽略。（能解决的处理一下，展示解决不了，或不影响项目的忽略【手动狗狗 ~】）

————————————————————————

2026年1月18日补充↓

在创建 CMake，有些时候我们会发现无法运行，将报错日志喂给 AI，我们不难发现Qt5 环境下缺少 GL/gl.h： 错误信息：Failed to find "GL/gl.h" in "/usr/include/libdrm" 这表明系统缺少 OpenGL 的头文件，或者它们不在标准路径。

解决方案：安装 OpenGL 的开发包。

在 Ubuntu/Debian 系统上，安装以下包： sudo apt install libgl1-mesa-dev

在 Fedora/CentOS 系统上： sudo dnf install mesa-libGL-devel

当我们在 Qt 首选项中看到构建套件 kit，中出现黄色的感叹号，不要慌，很好解决。

当出现如下图所示的情况，我们不难发现它们的共性，都是带有 WebAssembly 的纯在黄色的叹号标识。

我们不妨点击其中一个看看是什么引起的

很明显 Qt 版本这里有一个警告，是由于 Emscripten SDK 没有配置导致的。

当我们切换到 SDKs，点击 WebAssembly，没有安装配置过 Emscripten SDK，可以点击该界面上的 “Emscripten SDK”，参照官方的说明进行操作。

根据官网文档说明，我们先执行如下代码拉取，。如果拉取失败请尝试配置加速或者通过镜像站拉取源码解压到本地目录（本地目录最好用英文不要带中文路径，避免发生一些不可预料的问题，记住这个目录，后续会用到，我这里终端执行在 /home/gcoulu/SDK/ 目录下，cd 后在 /home/gcoulu/SDK/emsdk 目录下）

# Get the emsdk repo 获取emsdk仓库
git clone https://github.com/emscripten-core/emsdk.git

# Enter that directory 输入该目录(进入到该目录)
cd emsdk

# Fetch the latest version of the emsdk (not needed the first time you clone) 获取emsdk的最新版本（首次克隆时不需要）
git pull

# Download and install the latest SDK tools. 下载并安装最新的SDK工具。
./emsdk install latest

# Make the "latest" SDK "active" for the current user. (writes .emscripten file) 为当前用户“激活”“最新”SDK。（写入.emscripten文件）
./emsdk activate latest

# Activate PATH and other environment variables in the current terminal 激活当前终端中的PATH和其他环境变量
source ./emsdk_env.sh

执行完成后，我们可以验证一下是否安装到位（出现下图版本号的输出就没有太大的问题了，具体根据你所配置的版本来，因此版本号可能有不同）。

emcc --version

将 SDK 所在的目录在 Qt 首选项中配置好，我这里是 /home/gcoulu/SDK/

当出现上述画面则代表配置成功了，点击应用后确定再次打开首选项，构建套件 kit 中原本显示的黄色感叹号消失（Qt 版本中红色的感叹号消失），恭喜你配置成功了。

有些时候，当你在构建套件中展开 调试器 里面 LLDB form PATH on Build 前会有黄色的感叹号

此时若要使用 LLDB form PATH on Build，可通过如下命令安装

# LLDB通常与Clang/LLVM一起安装。你可以通过以下命令安装Clang/LLVM（这将包括LLDB）：
sudo apt-get install clang lldb

#对于其他Linux发行版，你可以查找相应的包管理器命令，例如在Fedora上使用dnf：
sudo dnf install clang lldb

确认 LLDB 安装

lldb --version
#执行后这里应该会显示LLDB的版本信息

查询 LLDB 的安装位置

找出LLDB的安装位置：
which lldb
或者，如果你不确定具体位置，可以使用find命令搜索：
sudo find / -name lldb 2>/dev/null

将 LLDB 添加到 PATH 环境变量

# 通常，通过包管理器安装的LLVM/CLang和LLDB应该会自动添加到系统的PATH环境变量中。但是，如果LLDB不在PATH中，你可以手动添加。

此时构建成功了，又可以愉快的玩耍了，哈哈哈！