如何在 Ubuntu 上安装 Qt 5：详细教程
1. 环境要求
操作系统：Ubuntu 20.04 或 Ubuntu 18.04（其他版本类似） 安装 Qt 5 的工具：终端（命令行界面）
2. 安装 Qt 5 的准备工作
在安装 Qt 5 之前，你需要确保系统具备一些基本的工具和依赖项。安装这些工具可以保证 Qt 能够正确编译和运行。
2.1 安装构建工具和依赖项
安装 Qt 5 依赖库：
sudo apt install libgl1-mesa-dev libxcb-xinerama0-dev libssl-dev
sudo apt install libfreetype6-dev libfontconfig1-dev
sudo apt install libicu-dev
sudo apt install libx11-dev libxext-dev libxrender-dev
sudo apt install libpng-dev
这些依赖库包括了图形库、字体库、输入法库等，确保 Qt 5 的 GUI 能正常显示。
安装一些必要的构建工具：
sudo apt install build-essential perl python3 git
更新你的软件包列表：
sudo apt update
3. 安装 Qt 5
你可以通过以下两种方法安装 Qt 5：
3.1 方法 1：通过 apt 安装 Qt 5
验证安装是否成功：
qmake --version
输出应该类似于：
QMake version 3.1 Using Qt version 5.x.x in /usr/lib/x86_64-linux-gnu/qt5
使用 apt 包管理器安装 Qt 5：
sudo apt install qt5-qmake qtbase5-dev
3.2 方法 2：通过 Qt 官方安装器安装 Qt 5（推荐）
如果你想使用最新版本的 Qt 5 或自定义安装路径，可以通过 Qt 官方安装器来安装。
- 下载 Qt 官方安装器：访问 Qt 官方下载页面 并下载适合 Linux 的 Qt Online Installer。
- 按照安装器的提示，选择 Qt 5 版本（例如 Qt 5.15.x），然后选择 安装路径 和其他组件（如 Qt Creator）。
- 安装完成后，Qt 将安装到你指定的目录（例如
/opt/Qt）。
运行安装器：
./qt-unified-linux-x64-.run
为安装器赋予执行权限：
chmod +x qt-unified-linux-x64-.run
4. 配置环境变量
安装 Qt 5 后，你需要设置环境变量，以便能够在命令行中方便地使用 qmake 和其他 Qt 工具。
4.1 设置 Qt 5 环境变量
打开终端，编辑 ~/.bashrc 文件（如果你使用的是 bash）或 ~/.zshrc（如果你使用的是 zsh）文件：
nano ~/.bashrc
在文件末尾添加以下内容（根据你的 Qt 安装路径进行替换）：
export QTDIR=/usr/lib/x86_64-linux-gnu/qt5
export PATH=$QTDIR/bin:$PATH
保存并退出文件，运行以下命令使配置生效：
source ~/.bashrc
4.2 检查 qmake 是否配置正确
运行以下命令，检查 qmake 是否已经正确指向 Qt 5：
qmake --version
输出应该类似于：
QMake version 3.1 Using Qt version 5.x.x in /usr/lib/x86_64-linux-gnu/qt5
5. 使用 Qt Creator
Qt Creator 是 Qt 官方提供的 IDE，能够帮助你更方便地进行 Qt 项目开发。你可以通过 Qt Creator 来创建、编辑、构建和调试 Qt 应用程序。
5.1 安装 Qt Creator
如果你还没有安装 Qt Creator，可以通过以下命令安装：
sudo apt install qtcreator
5.2 启动 Qt Creator
安装完成后，可以通过终端或者 应用菜单 启动 Qt Creator：
qtcreator
5.3 创建一个 Qt 项目
- 启动 Qt Creator 后，选择 File > New File or Project。
- 选择 Application > Qt Widgets Application 或 Qt Quick Application，然后点击 Choose。
- 设置项目名称、路径、选择 Qt 版本（如果有多个 Qt 版本），然后点击 Finish 完成创建。
5.4 编译和运行
在 Qt Creator 中，点击 Build 按钮来编译你的应用，并点击 Run 按钮来运行它。Qt Creator 会自动使用 qmake 来构建项目。
6. 使用命令行构建 Qt 项目
如果你更喜欢命令行开发，你可以通过 qmake 和 make 来构建和运行 Qt 项目。
6.1 创建一个新的 Qt 项目
创建一个新的项目文件夹并进入该目录：
mkdir myQtApp
cd myQtApp
创建一个简单的 main.cpp 文件：
#include <QApplication>
#include <QWidget>
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
QWidget window;
window.setWindowTitle("Hello Qt");
window.resize(250, 150);
window.show();
return app.exec();
}
使用 qmake 命令生成 Qt 项目文件：
qmake -project
6.2 生成 Makefile
在项目文件夹中运行 qmake 来生成 Makefile 文件：
qmake
6.3 编译项目
然后，使用 make 来编译项目：
make
6.4 运行项目
编译完成后，运行生成的可执行文件：
./myQtApp
7. 测试和调试
7.1 使用 Qt Creator 调试
在 Qt Creator 中，你可以使用内置的调试器来调试你的 Qt 应用程序。你可以设置断点、查看变量值、单步执行等。
7.2 使用 GDB 调试
如果你在命令行中工作，也可以通过 gdb 调试你的程序。首先确保在编译时启用了调试符号：
qmake CONFIG+=debug
make gdb ./myQtApp
8. 常见问题及解决方案
8.1 qmake 未找到
如果你遇到 qmake 未找到 的错误，确保你已正确设置环境变量，并运行以下命令检查：
echo $PATH
确保 $QTDIR/bin 目录在环境变量中。如果没有，你可能需要重新配置环境变量。
8.2 无法启动 Qt Creator
如果 Qt Creator 无法启动，检查是否安装了所有依赖项，并确保 qtcreator 命令在系统路径中。可以通过终端运行：
qtcreator
查看是否有错误输出，并根据错误信息解决问题。
总结
通过本教程，你可以在 Ubuntu 上顺利安装 Qt 5，并配置好开发环境。你可以选择通过 apt 安装或者通过 Qt 官方安装器来安装 Qt 5，并使用 Qt Creator 或 命令行 进行开发。
