【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。
  • 将其设置为默认的构建和运行套件。
相关推荐
还在忙碌的吴小二7 分钟前
Harness 最佳实践:Java Spring Boot 项目落地 OpenSpec + Claude Code
java·开发语言·spring boot·后端·spring
liliangcsdn7 分钟前
mstsc不在“C:\Windows\System32“下在C:\windows\WinSxS\anmd64xxx“问题分析
开发语言·windows
NineData14 分钟前
NineData 智能数据管理平台新功能发布|2026 年 3 月
数据库·oracle·架构·dba·ninedata·数据复制·数据迁移工具
小陈工18 分钟前
2026年4月7日技术资讯洞察:下一代数据库融合、AI基础设施竞赛与异步编程实战
开发语言·前端·数据库·人工智能·python
❀͜͡傀儡师19 分钟前
k8s部署的Nexus 3 数据库损坏恢复指南:从删除损坏数据库到完整数据重建
数据库·kubernetes·nexus3
KAU的云实验台21 分钟前
【算法精解】AIR期刊算法IAGWO:引入速度概念与逆多元二次权重,可应对高维/工程问题(附Matlab源码)
开发语言·算法·matlab
会编程的土豆27 分钟前
【数据结构与算法】再次全面了解LCS底层
开发语言·数据结构·c++·算法
jerryinwuhan38 分钟前
RDD第二次练习
开发语言·c#
wechat_Neal40 分钟前
Golang的车载应用场景
开发语言·后端·golang
StackNoOverflow1 小时前
Spring Security权限控制框架详解
java·数据库·sql