系列介绍这是系列文章的第一篇我将带你完成Qt开发环境的搭建并创建你的第一个Qt程序。 本篇你将学到Qt的下载和安装Qt Creator的基本使用创建和运行第一个Qt项目理解Qt项目的基本结构配置编译套件 系列目标从零到一开发一款完整的桌面应用——PDF全能工具箱 系列目录预告第2篇Qt信号槽机制详解第3篇Qt布局管理器完全指南第4篇Qt样式表QSS美化教程第5篇Qt常用控件全解析让我们开始吧一、什么是QtQt是一个跨平台的C应用程序开发框架由Qt Company维护。它被广泛应用于开发图形用户界面GUI应用程序也支持开发控制台工具和服务器端应用。使用Qt开发的知名软件WPS Office国产办公软件VirtualBox虚拟机软件VLC多媒体播放器Autodesk Maya3D建模软件Telegram Desktop即时通讯软件Qt的核心优势特性说明跨平台一套代码编译到Windows、Linux、macOS、Android、iOS信号槽独特的对象通信机制比回调函数更优雅丰富控件内置大量现成的UI组件文档完善官方文档详尽示例丰富开源免费采用LGPL协议商业应用也可免费使用二、Qt的下载与安装2.1 选择Qt版本目前主流版本Qt 5.15.x最后支持Win7的LTS版本成熟稳定Qt 6.x最新版本性能更好但不再支持Win7 推荐新手从Qt 5.15开始兼容性更好教程资源更丰富。2.2 下载方式方式一在线安装推荐访问Qt官方下载页面Index of /official_releases/online_installers下载对应系统的在线安装器Windowsqt-unified-windows-x64-online.exeLinuxqt-unified-linux-x64-online.runmacOSqt-unified-mac-x64-online.dmg注册/登录Qt账号免费注册方式二离线安装网络较差时选择访问Index of /archive/qt2.3 Windows安装步骤详解第1步双击运行安装器第2步登录Qt账号如果没有账号点击“Sign up”免费注册一个。第3步选择安装路径推荐D:\Qt\5.15.2 注意路径不要包含中文和空格第4步选择组件关键步骤展开Qt 5.15.2勾选以下组件✅ MinGW 8.1.0 64-bitWindows推荐使用 ✅ Qt Charts图表控件按需选择 ✅ Qt Virtual Keyboard虚拟键盘按需选择 ❌ Android相关组件不需要开发安卓可以取消 ❌ iOS相关组件不需要 ❌ Qt Source源码新手不需要展开Developer and Designer Tools✅ Qt CreatorIDE必选 ✅ MinGW 8.1.0 64-bit编译工具链必选 ✅ CMake构建工具推荐勾选 ✅ Ninja构建工具可选第5步接受协议开始安装安装大约需要10-20分钟大小约2-3GB。三、Qt Creator快速入门3.1 界面布局安装完成后打开Qt Creator界面分为以下几个区域┌─────────────────────────────────────────────────────────┐ │ 菜单栏 │ 文件 | 编辑 | 构建 | 调试 | 工具 | 帮助 │ ├──────────┬────────────────────────────────┬─────────────┤ │ │ │ │ │ 项目面板 │ │ 输出面板 │ │ (左侧) │ 代码编辑区 │ (底部) │ │ │ (中央) │ │ │ - 项目 │ │ - 编译输出 │ │ - 文件 │ │ - 应用输出 │ │ - 类视图 │ │ - 问题列表 │ │ │ │ │ ├──────────┴────────────────────────────────┴─────────────┤ │ 状态栏 │ └─────────────────────────────────────────────────────────┘3.2 常用快捷键快捷键功能说明CtrlN新建文件/项目最常用CtrlS保存当前文件养成好习惯CtrlB构建项目编译代码CtrlR运行项目编译运行Ctrl/注释/取消注释快速注释代码F4切换头文件/cpp文件快速跳转CtrlShiftF全局搜索搜索整个项目F5调试模式开始调试F10单步跳过调试时使用四、创建第一个Qt项目4.1 新建项目步骤1点击File→New File or Project或按CtrlN步骤2选择项目模板Projects → Application → Qt Widgets Application步骤3设置项目信息Name: HelloWorld Create in: D:\QtProjects步骤4选择构建套件勾选MinGW 64-bit确保绿色对勾表示配置正确步骤5设置类信息Class name: MainWindow Base class: QMainWindow步骤6点击完成项目创建成功4.2 项目文件结构创建完成后你会看到以下文件HelloWorld/ ├── HelloWorld.pro # 项目配置文件qmake ├── main.cpp # 主函数入口 ├── mainwindow.h # 主窗口头文件 ├── mainwindow.cpp # 主窗口实现文件 └── mainwindow.ui # 界面设计文件XML4.3 运行第一个程序方法1点击左下角的绿色三角形 ▶ 按钮方法2按CtrlR如果一切顺利你会看到一个空白的窗口弹出┌─────────────────────────────┐ │ ┌─┬─┬─┐│ │ HelloWorld │─│□│×││ │ ┌─────────────────────────┐│ │ │ ││ │ │ ││ │ │ 空白主窗口 ││ │ │ ││ │ │ ││ │ └─────────────────────────┘│ └─────────────────────────────┘恭喜你已经成功运行了第一个Qt程序五、添加一个简单的按钮让我们给窗口添加一个按钮点击时弹出问候语。5.1 使用代码添加按钮修改mainwindow.h#ifndef MAINWINDOW_H #define MAINWINDOW_H #include QMainWindow #include QPushButton // 新增按钮头文件 class MainWindow : public QMainWindow { Q_OBJECT public: MainWindow(QWidget *parent nullptr); ~MainWindow(); private slots: void onButtonClicked(); // 新增按钮点击响应函数 private: QPushButton *m_button; // 新增按钮指针 }; #endif修改mainwindow.cpp#include mainwindow.h #include QMessageBox // 新增消息对话框 MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { // 创建按钮 m_button new QPushButton(点击我, this); // 设置按钮位置和大小 m_button-setGeometry(100, 100, 200, 50); // 连接信号槽按钮被点击时调用onButtonClicked函数 connect(m_button, QPushButton::clicked, this, MainWindow::onButtonClicked); } MainWindow::~MainWindow() { } void MainWindow::onButtonClicked() { // 弹出问候消息 QMessageBox::information(this, 问候, Hello, Qt World!); }5.2 运行效果再次运行程序CtrlR你会看到一个带按钮的窗口┌─────────────────────────────┐ │ HelloWorld ┌─┬─┬─┐ │ │ ┌─────────────────────────┐│ │ │ ││ │ │ ┌──────────────┐ ││ │ │ │ 点击我 │ ││ │ │ └──────────────┘ ││ │ │ ││ │ └─────────────────────────┘│ └─────────────────────────────┘ 点击按钮后弹出对话框 ┌─────────────────────────────┐ │ 问候 │ │ ┌─────────────────────────┐│ │ │ Hello, Qt World! ││ │ │ ││ │ │ [确定] ││ │ └─────────────────────────┘│ └─────────────────────────────┘六、常见问题及解决方案Q1编译时报错 No valid kits found原因没有配置编译套件解决Tools → Options → Kits → Add 选择已安装的MinGW编译器Q2中文显示乱码解决在代码开头添加#include QTextCodec // 在main函数中 QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8));或者使用QStringLiteral宏m_button-setText(QStringLiteral(点击我));Q3运行时提示缺少dll原因Qt动态库不在系统路径解决开发阶段通过Qt Creator运行会自动设置环境发布阶段使用windeployqt工具打包Q4无法找到头文件解决检查.pro文件是否添加了对应模块# 例如需要使用多媒体功能 QT multimedia七、本课小结通过本篇学习你完成了✅ Qt开发环境的安装和配置✅ 熟悉了Qt Creator的基本操作✅ 创建并运行了第一个Qt程序✅ 添加了按钮和事件响应✅ 了解了常见问题的解决方法下一课预告第2篇「Qt信号槽机制详解」——我们将深入Qt最核心的特性理解对象之间如何高效通信。这是Qt编程的灵魂所在掌握它你就掌握了Qt的精髓课后练习尝试修改按钮的文字和位置添加第二个按钮实现不同的功能尝试修改窗口的标题和大小系列进度状态篇数文章标题✅ 已完成第1篇Qt环境搭建与第一个Hello World 待发布第2篇Qt信号槽机制详解 待发布第3篇Qt布局管理器完全指南 待发布第4篇Qt样式表QSS美化教程 待发布第5篇Qt常用控件全解析 待发布第6篇Qt对话框系统 待发布第7篇QProcess调用外部程序 待发布第8篇QFile文件操作详解如果觉得有用欢迎点赞、收藏、关注有问题欢迎评论区留言我会及时回复。下期见
【Qt/C++ 桌面开发实战营】第1篇：Qt环境搭建与第一个Hello World
系列介绍这是系列文章的第一篇我将带你完成Qt开发环境的搭建并创建你的第一个Qt程序。 本篇你将学到Qt的下载和安装Qt Creator的基本使用创建和运行第一个Qt项目理解Qt项目的基本结构配置编译套件 系列目标从零到一开发一款完整的桌面应用——PDF全能工具箱 系列目录预告第2篇Qt信号槽机制详解第3篇Qt布局管理器完全指南第4篇Qt样式表QSS美化教程第5篇Qt常用控件全解析让我们开始吧一、什么是QtQt是一个跨平台的C应用程序开发框架由Qt Company维护。它被广泛应用于开发图形用户界面GUI应用程序也支持开发控制台工具和服务器端应用。使用Qt开发的知名软件WPS Office国产办公软件VirtualBox虚拟机软件VLC多媒体播放器Autodesk Maya3D建模软件Telegram Desktop即时通讯软件Qt的核心优势特性说明跨平台一套代码编译到Windows、Linux、macOS、Android、iOS信号槽独特的对象通信机制比回调函数更优雅丰富控件内置大量现成的UI组件文档完善官方文档详尽示例丰富开源免费采用LGPL协议商业应用也可免费使用二、Qt的下载与安装2.1 选择Qt版本目前主流版本Qt 5.15.x最后支持Win7的LTS版本成熟稳定Qt 6.x最新版本性能更好但不再支持Win7 推荐新手从Qt 5.15开始兼容性更好教程资源更丰富。2.2 下载方式方式一在线安装推荐访问Qt官方下载页面Index of /official_releases/online_installers下载对应系统的在线安装器Windowsqt-unified-windows-x64-online.exeLinuxqt-unified-linux-x64-online.runmacOSqt-unified-mac-x64-online.dmg注册/登录Qt账号免费注册方式二离线安装网络较差时选择访问Index of /archive/qt2.3 Windows安装步骤详解第1步双击运行安装器第2步登录Qt账号如果没有账号点击“Sign up”免费注册一个。第3步选择安装路径推荐D:\Qt\5.15.2 注意路径不要包含中文和空格第4步选择组件关键步骤展开Qt 5.15.2勾选以下组件✅ MinGW 8.1.0 64-bitWindows推荐使用 ✅ Qt Charts图表控件按需选择 ✅ Qt Virtual Keyboard虚拟键盘按需选择 ❌ Android相关组件不需要开发安卓可以取消 ❌ iOS相关组件不需要 ❌ Qt Source源码新手不需要展开Developer and Designer Tools✅ Qt CreatorIDE必选 ✅ MinGW 8.1.0 64-bit编译工具链必选 ✅ CMake构建工具推荐勾选 ✅ Ninja构建工具可选第5步接受协议开始安装安装大约需要10-20分钟大小约2-3GB。三、Qt Creator快速入门3.1 界面布局安装完成后打开Qt Creator界面分为以下几个区域┌─────────────────────────────────────────────────────────┐ │ 菜单栏 │ 文件 | 编辑 | 构建 | 调试 | 工具 | 帮助 │ ├──────────┬────────────────────────────────┬─────────────┤ │ │ │ │ │ 项目面板 │ │ 输出面板 │ │ (左侧) │ 代码编辑区 │ (底部) │ │ │ (中央) │ │ │ - 项目 │ │ - 编译输出 │ │ - 文件 │ │ - 应用输出 │ │ - 类视图 │ │ - 问题列表 │ │ │ │ │ ├──────────┴────────────────────────────────┴─────────────┤ │ 状态栏 │ └─────────────────────────────────────────────────────────┘3.2 常用快捷键快捷键功能说明CtrlN新建文件/项目最常用CtrlS保存当前文件养成好习惯CtrlB构建项目编译代码CtrlR运行项目编译运行Ctrl/注释/取消注释快速注释代码F4切换头文件/cpp文件快速跳转CtrlShiftF全局搜索搜索整个项目F5调试模式开始调试F10单步跳过调试时使用四、创建第一个Qt项目4.1 新建项目步骤1点击File→New File or Project或按CtrlN步骤2选择项目模板Projects → Application → Qt Widgets Application步骤3设置项目信息Name: HelloWorld Create in: D:\QtProjects步骤4选择构建套件勾选MinGW 64-bit确保绿色对勾表示配置正确步骤5设置类信息Class name: MainWindow Base class: QMainWindow步骤6点击完成项目创建成功4.2 项目文件结构创建完成后你会看到以下文件HelloWorld/ ├── HelloWorld.pro # 项目配置文件qmake ├── main.cpp # 主函数入口 ├── mainwindow.h # 主窗口头文件 ├── mainwindow.cpp # 主窗口实现文件 └── mainwindow.ui # 界面设计文件XML4.3 运行第一个程序方法1点击左下角的绿色三角形 ▶ 按钮方法2按CtrlR如果一切顺利你会看到一个空白的窗口弹出┌─────────────────────────────┐ │ ┌─┬─┬─┐│ │ HelloWorld │─│□│×││ │ ┌─────────────────────────┐│ │ │ ││ │ │ ││ │ │ 空白主窗口 ││ │ │ ││ │ │ ││ │ └─────────────────────────┘│ └─────────────────────────────┘恭喜你已经成功运行了第一个Qt程序五、添加一个简单的按钮让我们给窗口添加一个按钮点击时弹出问候语。5.1 使用代码添加按钮修改mainwindow.h#ifndef MAINWINDOW_H #define MAINWINDOW_H #include QMainWindow #include QPushButton // 新增按钮头文件 class MainWindow : public QMainWindow { Q_OBJECT public: MainWindow(QWidget *parent nullptr); ~MainWindow(); private slots: void onButtonClicked(); // 新增按钮点击响应函数 private: QPushButton *m_button; // 新增按钮指针 }; #endif修改mainwindow.cpp#include mainwindow.h #include QMessageBox // 新增消息对话框 MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { // 创建按钮 m_button new QPushButton(点击我, this); // 设置按钮位置和大小 m_button-setGeometry(100, 100, 200, 50); // 连接信号槽按钮被点击时调用onButtonClicked函数 connect(m_button, QPushButton::clicked, this, MainWindow::onButtonClicked); } MainWindow::~MainWindow() { } void MainWindow::onButtonClicked() { // 弹出问候消息 QMessageBox::information(this, 问候, Hello, Qt World!); }5.2 运行效果再次运行程序CtrlR你会看到一个带按钮的窗口┌─────────────────────────────┐ │ HelloWorld ┌─┬─┬─┐ │ │ ┌─────────────────────────┐│ │ │ ││ │ │ ┌──────────────┐ ││ │ │ │ 点击我 │ ││ │ │ └──────────────┘ ││ │ │ ││ │ └─────────────────────────┘│ └─────────────────────────────┘ 点击按钮后弹出对话框 ┌─────────────────────────────┐ │ 问候 │ │ ┌─────────────────────────┐│ │ │ Hello, Qt World! ││ │ │ ││ │ │ [确定] ││ │ └─────────────────────────┘│ └─────────────────────────────┘六、常见问题及解决方案Q1编译时报错 No valid kits found原因没有配置编译套件解决Tools → Options → Kits → Add 选择已安装的MinGW编译器Q2中文显示乱码解决在代码开头添加#include QTextCodec // 在main函数中 QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8));或者使用QStringLiteral宏m_button-setText(QStringLiteral(点击我));Q3运行时提示缺少dll原因Qt动态库不在系统路径解决开发阶段通过Qt Creator运行会自动设置环境发布阶段使用windeployqt工具打包Q4无法找到头文件解决检查.pro文件是否添加了对应模块# 例如需要使用多媒体功能 QT multimedia七、本课小结通过本篇学习你完成了✅ Qt开发环境的安装和配置✅ 熟悉了Qt Creator的基本操作✅ 创建并运行了第一个Qt程序✅ 添加了按钮和事件响应✅ 了解了常见问题的解决方法下一课预告第2篇「Qt信号槽机制详解」——我们将深入Qt最核心的特性理解对象之间如何高效通信。这是Qt编程的灵魂所在掌握它你就掌握了Qt的精髓课后练习尝试修改按钮的文字和位置添加第二个按钮实现不同的功能尝试修改窗口的标题和大小系列进度状态篇数文章标题✅ 已完成第1篇Qt环境搭建与第一个Hello World 待发布第2篇Qt信号槽机制详解 待发布第3篇Qt布局管理器完全指南 待发布第4篇Qt样式表QSS美化教程 待发布第5篇Qt常用控件全解析 待发布第6篇Qt对话框系统 待发布第7篇QProcess调用外部程序 待发布第8篇QFile文件操作详解如果觉得有用欢迎点赞、收藏、关注有问题欢迎评论区留言我会及时回复。下期见
