如何在 Linux_Ubuntu 上安装 Qt 5：详细教程

如何在 Ubuntu 上安装 Qt 5：详细教程

在这篇教程中，我将详细讲解如何在 Ubuntu 系统上安装 Qt 5，包括 下载、安装、配置 和 测试 的全过程。通过这个教程，你将能够安装 Qt 5，并解决常见的问题。

---

1. 环境要求

操作系统：Ubuntu 20.04 或 Ubuntu 18.04（其他版本类似）
安装 Qt 5 的工具：终端（命令行界面）

---

2. 安装 Qt 5 的准备工作

在安装 Qt 5 之前，你需要确保系统具备一些基本的工具和依赖项。安装这些工具可以保证 Qt 能够正确编译和运行。

2.1 安装构建工具和依赖项

1. 更新你的软件包列表：

   sudo apt update
   

2. 安装一些必要的构建工具：

   sudo apt install build-essential perl python3 git
   

3. 安装 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 能正常显示。

---

3. 安装 Qt 5

你可以通过以下两种方法安装 Qt 5：

3.1 方法 1：通过 apt 安装 Qt 5

1. 使用 apt 包管理器安装 Qt 5：

   sudo apt install qt5-qmake qtbase5-dev
   

2. 验证安装是否成功：

   qmake --version
   

   输出应该类似于：

   QMake version 3.1
   Using Qt version 5.x.x in /usr/lib/x86_64-linux-gnu/qt5
   

3.2 方法 2：通过 Qt 官方安装器安装 Qt 5（推荐）

如果你想使用最新版本的 Qt 5 或自定义安装路径，可以通过 Qt 官方安装器 来安装。

1. 下载 Qt 官方安装器：

   访问 Qt 官方下载页面 并下载适合 Linux 的 Qt Online Installer。

2. 为安装器赋予执行权限：

   chmod +x qt-unified-linux-x64-.run
   

3. 运行安装器：

   ./qt-unified-linux-x64-.run
   

4. 按照安装器的提示，选择 Qt 5 版本（例如 Qt 5.15.x），然后选择 安装路径 和其他组件（如 Qt Creator）。

5. 安装完成后，Qt 将安装到你指定的目录（例如 /opt/Qt）。

---

4. 配置环境变量

安装 Qt 5 后，你需要设置环境变量，以便能够在命令行中方便地使用 qmake 和其他 Qt 工具。

4.1 设置 Qt 5 环境变量

1. 打开终端，编辑 ~/.bashrc 文件（如果你使用的是 bash）或 ~/.zshrc（如果你使用的是 zsh）文件：

   nano ~/.bashrc   # 如果使用 bash
   # 或
   nano ~/.zshrc    # 如果使用 zsh
   

2. 在文件末尾添加以下内容（根据你的 Qt 安装路径进行替换）：

   export QTDIR=/usr/lib/x86_64-linux-gnu/qt5  # 如果是通过 apt 安装的 Qt 5
   # 或者
   export QTDIR=/opt/Qt/5.x.x/gcc_64         # 如果是通过 Qt 官方安装器安装的 Qt 5
   export PATH=$QTDIR/bin:$PATH
   

3. 保存并退出文件，运行以下命令使配置生效：

   source ~/.bashrc   # 如果使用 bash
   # 或
   source ~/.zshrc    # 如果使用 zsh
   

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 项目

1. 启动 Qt Creator 后，选择 File > New File or Project。
2. 选择 Application > Qt Widgets Application 或 Qt Quick Application，然后点击 Choose。
3. 设置项目名称、路径、选择 Qt 版本（如果有多个 Qt 版本），然后点击 Finish 完成创建。

5.4 编译和运行

在 Qt Creator 中，点击 Build 按钮来编译你的应用，并点击 Run 按钮来运行它。Qt Creator 会自动使用 qmake 来构建项目。

---

6. 使用命令行构建 Qt 项目

如果你更喜欢命令行开发，你可以通过 qmake 和 make 来构建和运行 Qt 项目。

6.1 创建一个新的 Qt 项目

1. 创建一个新的项目文件夹并进入该目录：

   mkdir myQtApp
   cd myQtApp
   

2. 使用 qmake 命令生成 Qt 项目文件：

   qmake -project
   

3. 创建一个简单的 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();
   }
   

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 或 命令行 进行开发。希望这篇文档能够帮助你快速上手 Qt 5，未来如果需要重新安装 Qt 5，你可以参考这篇博客！