Qt安装后第一件事：手把手教你配置环境变量和创建Hello World项目（Win10 + Qt 5.12）
Qt安装后第一件事：手把手教你配置环境变量和创建Hello World项目（Win10 + Qt 5.12）
刚完成Qt安装的新手开发者常会遇到这样的困境：明明按照教程一步步操作，安装程序也显示成功，但打开Qt Creator后却不知从何下手。本文将带你完成两个关键动作——配置系统环境变量和创建首个Hello World项目，让你真正迈出Qt开发的第一步。
1. 环境变量配置：让系统识别Qt工具链
许多初学者跳过环境变量配置直接创建项目，结果在编译阶段遭遇"无法找到qmake"等错误。正确的环境配置能确保命令行和IDE无缝调用Qt工具。
1.1 定位关键目录
首先需要确认两个核心路径（假设安装路径为D:\Qt5.12.6）：
- Qt编译器路径：
D:\Qt5.12.6\5.12.6\mingw73_64\bin - Qt工具路径：
D:\Qt5.12.6\Tools\mingw730_64\bin
提示：实际路径可能因安装版本不同而变化，建议在文件管理器中确认目录存在再继续
1.2 配置系统PATH变量
按Win+S搜索"环境变量"，选择"编辑系统环境变量"：
- 在"系统属性"窗口点击"环境变量"
- 在"系统变量"区域找到"Path"并双击
- 点击"新建"添加上述两个路径
- 逐级点击"确定"保存设置
验证配置是否生效：
qmake --version正常应显示类似信息：
QMake version 3.1 Using Qt version 5.12.6 in D:/Qt5.12.6/5.12.6/mingw73_64/lib2. 创建首个Qt项目：从空白到运行
2.1 项目初始化
启动Qt Creator后：
- 点击"文件"→"新建文件或项目"
- 选择"Application"→"Qt Widgets Application"
- 设置项目名称（如
HelloQt）和路径 - 在"Kit Selection"保持默认的Desktop Qt 5.12.6 MinGW 64-bit
- 取消勾选"Generate form"，我们先用代码创建界面
2.2 理解项目结构
创建完成后IDE会自动生成以下关键文件：
main.cpp：程序入口文件HelloQt.pro：项目配置文件CMakeLists.txt：CMake构建文件（如果选择CMake项目）
重点查看.pro文件中的关键配置：
QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets TARGET = HelloQt TEMPLATE = app SOURCES += main.cpp2.3 编写Hello World代码
替换main.cpp内容为：
#include <QApplication> #include <QLabel> int main(int argc, char *argv[]) { QApplication app(argc, argv); QLabel *label = new QLabel("Hello Qt World!"); label->setWindowTitle("My First Qt App"); label->resize(400, 300); label->show(); return app.exec(); }代码解析：
QApplication：管理应用程序级资源QLabel：用于显示文本的基础控件show()：使窗口可见app.exec()：启动事件循环
3. 构建与调试：解决常见问题
3.1 首次构建准备
点击左下角的"构建"按钮（锤子图标）时可能会遇到：
错误1：
Cannot find -lGL解决方案：在.pro文件中添加：win32:LIBS += -lopengl32错误2：
No such file or directory检查：项目→构建设置→构建目录是否包含中文或空格
3.2 调试技巧
按F5启动调试时：
- 在关键代码行左侧点击设置断点
- 使用调试工具栏单步执行
- 查看"局部变量和表达式"窗口
常用调试快捷键：
| 快捷键 | 功能 |
|---|---|
| F5 | 开始调试 |
| F10 | 单步跳过 |
| F11 | 单步进入 |
| Shift+F5 | 停止调试 |
4. 进阶配置：提升开发效率
4.1 自定义构建套件
进入"工具"→"选项"→"Kits"可：
- 添加不同Qt版本
- 配置交叉编译工具链
- 设置Android开发环境
4.2 实用插件推荐
通过"帮助"→"关于插件"启用：
- Clang Code Model：增强代码补全
- Git：版本控制集成
- QML Profiler：性能分析工具
4.3 项目模板优化
将配置好的项目保存为模板：
- 文件→新建文件或项目→其他项目→Import Project
- 选择"Qt Creator Project Template"
- 下次新建时可快速复用配置