【Qt】乌班图安装Qt环境

完整流程：

第 1 步：更新系统
打开终端，执行以下命令，确保所有软件包都是最新的。

sudo apt update
sudo apt upgrade

第 2 步：安装基础编译工具
安装 C++ 编译器、构建工具等开发所必需的基础软件包。

sudo apt install build-essential

(这个命令会自动安装 gcc, g++, make 等核心工具)

第 3 步：安装 Qt 5.12.8 核心库和工具
这是安装 Qt 的关键步骤。我们将精确安装所需的核心组件，而不是使用危险的通配符 *。

sudo apt install qtbase5-dev qt5-qmake qtcreator

• qtbase5-dev: Qt 5 的核心开发库（在 Ubuntu 20.04 上就是 5.12.8 版本）。
• qt5-qmake: Qt 的项目构建文件生成器。
• qtcreator: Qt 的官方集成开发环境（IDE）。

第 4 步：验证安装

1. 启动 Qt Creator：在应用菜单中找到并打开 “Qt Creator”。
2. 创建新项目：点击 “New Project” -> 选择 “Application” -> “Qt Widgets Application” -> 点击 “Choose…”。
3. 配置项目：
   • 给项目命名（如 MyTestApp）。
   • 在 “Build System” 中选择 qmake。
   • 在 “Kit Selection” 页面，你应该能看到一个自动检测到的套件 (Kit)，名为 “Desktop Qt 5.12.8 GCC 64bit”。确保它被选中。
   • 一路点击 “Next” 直到 “Finish”。
4. 运行项目：点击左下角的绿色 “Run” 按钮（或按 Ctrl+R）。
5. 检查结果：如果一个标题为 MyTestApp 的空白窗口成功弹出，恭喜你，Qt 5.12.8 环境已通过 apt 成功安装！

如果没有自动检测到Kit

**简单来说，Kit 是一个 “开发套件”，它把 Qt 版本、编译器 和 调试器 这三样东西捆绑在一起。Qt Creator 需要知道这三样东西的位置，才能为你构建和运行程序。

自动检测失败通常意味着 Qt Creator 没有找到其中一个或多个组件的路径。我们来一步步排查并手动配置。

---

核心排查思路：确认三大件是否存在

请在终端中依次运行以下三个命令，检查你的系统中是否已经正确安装了这三个核心组件。

1. 检查 Qt 版本 (qmake)

   bash

   qmake --version
   

   • 预期输出: 应该显示 Qt 5.12.8 版本信息。如果提示 qmake: command not found，说明 Qt 库没有安装或其路径没有被添加到系统环境变量中。

2. 检查编译器 (g++)

   g++ --version
   

   • 预期输出: 应该显示 GCC 编译器的版本信息（如 9.4.0）。如果提示 g++: command not found，说明你没有安装 build-essential。

3. 检查调试器 (gdb)

   bash

   gdb --version
   

   • 预期输出: 应该显示 GDB 调试器的版本信息。如果提示 gdb: command not found，说明你没有安装调试工具。

---

解决方案：手动配置 Kit

如果上面的命令都能正常运行，说明三大件都已安装，只是 Qt Creator 没找到它们。我们来手动告诉它。

第 1 步：打开 Qt Creator 的选项

• 进入菜单 Tools -> Options...。

第 2 步：添加 Qt 版本

• 在左侧导航栏选择 Qt Versions。
• 点击右侧的 Add... 按钮。
• 在弹出的文件选择器中，找到你的 Qt 5.12.8 安装路径。
  • 如果你用 apt 安装的: 路径通常在 /usr/lib/x86_64-linux-gnu/qt5/bin/qmake。
  • 如果你用官方安装器安装的: 路径通常在 /opt/Qt5.12.8/5.12.8/gcc_64/bin/qmake。
• 选中 qmake 文件并打开。Qt Creator 会自动识别出这是 Qt 5.12.8。点击 Apply。

第 3 步：确认编译器

• 在左侧导航栏选择 Compilers。
• Qt Creator 通常能自动检测到系统中的 gcc 和 g++。检查是否有 GCC 或 Clang 的条目。如果没有，点击 Add -> GCC -> C++ Compiler，然后手动指向 /usr/bin/g++。

第 4 步：确认调试器

• 在左侧导航栏选择 Debuggers。
• 同样，Qt Creator 通常能自动检测到 gdb。检查是否有 GDB 的条目。如果没有，点击 Add，然后手动指向 /usr/bin/gdb。

第 5 步：创建 Kit

• 在左侧导航栏选择 Kits。
• 点击右侧的 Add 按钮。
• 配置新的 Kit
  • Name: 给它起个名字，例如 My Desktop Qt 5.12.8。
  • Device Type: 选择 Desktop。
  • Compiler: 在下拉菜单中选择你确认好的 g++ 编译器。
  • Debugger: 在下拉菜单中选择你确认好的 GDB 调试器。
  • Qt Version: 在下拉菜单中选择你刚刚手动添加的 Qt 5.12.8。
• 填写完毕后，点击 Apply 或 OK。

第 6 步：应用新的 Kit

• 回到 Qt Creator 的主界面。
• 在左侧的 “Projects” (项目) 面板中，点击你当前的项目。
• 在 “Build & Run” 标签页下，你应该能看到刚刚创建的 Kit。
• 将其设置为默认的构建和运行套件。