Qt安装后第一件事：手把手带你用Qt Creator 12.0.1创建并运行第一个窗口程序-洪萨配资

Qt安装后第一件事：手把手带你用Qt Creator 12.0.1创建并运行第一个窗口程序

刚完成Qt安装的新手开发者，面对功能丰富的Qt Creator界面时，常会陷入"工具已就位却不知从何下手"的困境。本文将带你用最新社区版Qt Creator 12.0.1，在15分钟内完成从项目创建到窗口程序运行的完整流程，通过实践验证开发环境配置正确性，同时掌握基础工作流程。

1. 启动与界面初探

安装完成后，在开始菜单找到Qt Creator 12.0.1 (Community)启动。首次启动会显示欢迎界面，左侧导航栏包含以下几个关键功能区：

Projects：最近项目和创建新项目的入口
Examples：官方示例代码库
Tutorials：交互式教程
Courses：在线学习资源

提示：如果界面语言显示异常，可通过菜单栏Tools→Options→Environment→Interface调整语言设置

主工作区默认布局包含：

代码编辑器（中央区域）
项目文件树（左侧）
输出窗口（下方）
调试/编译控制台（下方）

2. 创建第一个GUI项目

点击欢迎界面中的Create Project按钮，或通过菜单栏File→New Project启动向导。关键步骤解析：

2.1 选择项目类型

在Application分类下选择Qt Widgets Application，这是最传统的桌面GUI开发方式。其他常见选项对比：

项目类型	适用场景	学习曲线
Qt Widgets Application	传统桌面应用	低
Qt Quick Application	现代UI/移动端/嵌入式	中
Console Application	命令行程序	低

2.2 配置项目详情

在Project Location页面需要关注：

项目名称：使用英文且不含空格（如FirstWindowApp）
创建路径：建议专门建立Qt项目目录
构建系统：新手建议选择qmake（更简单），有CMake经验者可选CMake

构建系统选择建议：

# qmake项目典型结构 FirstWindowApp.pro # 项目配置文件 main.cpp # 程序入口 mainwindow.cpp # 主窗口实现 # CMake项目典型结构 CMakeLists.txt # 构建配置 main.cpp MainWindow.cpp

2.3 类定义配置

在Class Information页面保持默认设置：

基类选择QMainWindow
自动生成mainwindow.h/cpp和main.cpp
勾选Generate form选项（用于可视化设计）

3. 理解项目结构

创建完成后，项目文件树会显示以下核心文件：

FirstWindowApp/ ├── CMakeLists.txt # CMake构建配置 ├── main.cpp # 程序入口 ├── MainWindow.cpp # 主窗口实现 ├── MainWindow.h # 主窗口头文件 └── MainWindow.ui # 界面设计文件

关键文件作用说明：

main.cpp- 程序入口：

#include "MainWindow.h" #include <QApplication> int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); }

MainWindow.ui- 双击可用设计器可视化编辑界面

4. 构建与运行

4.1 编译器配置检查

点击左下角Projects图标，确认：

已自动检测到安装的Qt套件（如Desktop Qt 6.6.1 MinGW 64-bit）
构建目录设置合理（默认在项目目录下）

注意：如果显示黄色警告图标，表示需要手动选择Qt版本或编译器

4.2 执行构建

使用以下任一方式启动构建：

点击左下角绿色三角运行按钮（▶）
快捷键Ctrl+R（Windows/Linux）或Cmd+R（Mac）
菜单栏Build→Run

首次构建会经历：

生成Makefile（qmake）或配置CMake
编译源代码
链接生成可执行文件
自动运行程序

4.3 验证结果

成功运行后将显示空白主窗口，控制台输出类似：

Starting /path/to/FirstWindowApp... Application output: Process finished with exit code 0

常见问题排查：

报错"Could not find make command"：检查MinGW是否安装正确
报错"Qt version is not properly installed"：重新运行MaintenanceTool修复安装
程序闪退：检查环境变量是否包含Qt的bin目录

5. 进阶探索方向

完成基础验证后，可以尝试以下扩展：

5.1 界面设计实践

双击MainWindow.ui打开设计器
从左侧Widget Box拖拽按钮(Button)到窗口
右键按钮选择Go to slot...创建点击事件处理
重新构建运行测试交互

5.2 调试技巧

设置断点：点击代码行号左侧区域
启动调试：使用黄色小虫图标或F5键
查看变量：调试模式下Locals窗口

5.3 项目配置调整

在.pro文件（qmake）或CMakeLists.txt中添加常用配置：

# qmake示例：添加C++17支持 CONFIG += c++17 # 添加第三方库链接 LIBS += -L/path/to/lib -lmylib

# CMake示例：设置C++标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 查找并链接Qt模块 find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(FirstWindowApp PRIVATE Qt6::Widgets)

6. 开发环境优化建议

提升Qt Creator使用效率的几个设置：

代码补全：
- Tools→Options→Text Editor→Completion
- 启用Auto-insert brackets和Highlight matches
快捷键自定义：
- Tools→Options→Environment→Keyboard
- 常用操作建议绑定：
  - 构建运行：Ctrl+R
  - 快速修复：Alt+Enter
  - 切换头/源文件：F4
主题调整：
- Tools→Options→Environment→Interface
- 支持暗色模式(Dark)和高对比度主题
插件管理：
- Tools→Options→Environment→Plugins
- 推荐启用：
  - Version Control（Git集成）
  - Beautifier（代码格式化）
  - QML Profiler（性能分析）