【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。
  • 将其设置为默认的构建和运行套件。
相关推荐
凡人叶枫18 小时前
Effective C++ 条款41:了解隐式接口和编译期多态
java·开发语言·c++·effective c++
秉承初心19 小时前
PostgreSQL 数据性能瓶颈突破实战
数据库·postgresql·oracle
2601_9547064919 小时前
云手机技术详解+Python实战调用|2026高稳云手机平台推荐
开发语言·python·智能手机
chushiyunen19 小时前
java中的路径处理、左右斜杠
java·开发语言·python
Database_Cool_19 小时前
即席查询(Ad-Hoc)数据库选型:AnalyticDB MySQL 秒级 Ad-Hoc 分析方案
数据库·mysql
森G19 小时前
75、服务器源码解析---------云视频服务项目
linux·服务器·网络·c++·qt
Nontee19 小时前
新手数据库进阶:一条UPDATE语句的“奇妙漂流”
数据库
重生之后端学习19 小时前
Java入门
java·开发语言·职场和发展
碧海蓝天202219 小时前
C++法则24:在标准 C++ 中,没有任何可移植的方式判断指针 T* pt 指向的内存位置是否已经 构造了对象,程序员必须手动跟踪哪些元素已构造。
java·开发语言·c++