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.cpp2.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（性能分析）
遇到问题时，可通过Help→System Information查看完整环境配置，这对技术社区求助时提供详细信息很有帮助。