【Qt】乌班图安装Qt环境

完整流程:

第 1 步:更新系统

打开终端,执行以下命令,确保所有软件包都是最新的。

bash 复制代码
sudo apt update
sudo apt upgrade

第 2 步:安装基础编译工具

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

bash 复制代码
sudo apt install build-essential

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

第 3 步:安装 Qt 5.12.8 核心库和工具

这是安装 Qt 的关键步骤。我们将精确安装所需的核心组件,而不是使用危险的通配符 *

bash 复制代码
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

    bash 复制代码
    qmake --version
    • 预期输出 : 应该显示 Qt 5.12.8 版本信息。如果提示 qmake: command not found,说明 Qt 库没有安装或其路径没有被添加到系统环境变量中。
  2. 检查编译器 (g++)

    bash 复制代码
    g++ --version
    • 预期输出 : 应该显示 GCC 编译器的版本信息(如 9.4.0)。如果提示 g++: command not found,说明你没有安装 build-essential
  3. 检查调试器 (gdb)

    bash

    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 通常能自动检测到系统中的 gccg++。检查是否有 GCCClang 的条目。如果没有,点击 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
  • 填写完毕后,点击 ApplyOK

第 6 步:应用新的 Kit

  • 回到 Qt Creator 的主界面。
  • 在左侧的 "Projects" (项目) 面板中,点击你当前的项目。
  • 在 "Build & Run" 标签页下,你应该能看到刚刚创建的 Kit。
  • 将其设置为默认的构建和运行套件。
相关推荐
kyle~4 小时前
C++STL---静态数组array
开发语言·c++
wuyunhang1234564 小时前
MySQL----触发器
数据库·mysql
~无忧花开~4 小时前
JavaScript学习笔记(二十八):JavaScript性能优化全攻略
开发语言·前端·javascript·笔记·学习·性能优化·js
ptc学习者5 小时前
OGG 安装注意事项
java·开发语言·数据库
蓝天智能5 小时前
QT MVC中Model的特点及使用注意事项
qt·mvc
kk”5 小时前
C++ List
开发语言·c++
鸽鸽程序猿5 小时前
【MySQL】索引
数据库·mysql
zym大哥大5 小时前
Redis-Zest
数据库·redis·缓存
zl9798996 小时前
Redis-stream、bitfield类型
数据库·redis·缓存