Qt 开发环境搭建完整文档

一、文档说明本文档详细介绍Windows 系统下 Qt 开发环境的完整搭建流程包含 Qt 下载、安装、环境配置、项目测试适用于 Qt 5.x/ Qt 6.x 版本零基础也可直接跟着操作。二、环境准备1. 系统要求Windows 10 / Windows 1164 位内存 ≥ 4GB硬盘剩余空间 ≥ 20GB网络通畅用于下载安装包和组件2. 版本选择新手推荐Qt 5.15.2稳定、兼容性强、教程最多进阶推荐Qt 6.5新版本功能更全部分旧库不兼容本文以Qt 5.15.2为例演示。三、Qt 下载1. 官方下载地址Qt 官方离线安装包推荐无需联网反复下载https://download.qt.io/archive/qt/2. 下载步骤打开链接 → 找到5.15→ 点击5.15.2选择 Windows 版本安装包qt-opensource-windows-x86-5.15.2.exe等待下载完成安装包大小约 3.5GB注意无需注册 Qt 账号安装时可跳过登录。四、Qt 安装步骤1. 启动安装程序双击下载好的.exe安装包弹出登录界面 → 点击Skip跳过登录2. 选择安装路径重要安装路径不能有中文、空格、特殊字符推荐路径D:\Qt\Qt5.15.23. 选择安装组件核心步骤勾选以下必选组件其他默认不选Qt 5.15.2✅MinGW 7.3.0 64-bit编译器必选✅Qt Creator 4.13.1IDE 开发工具必选✅Sources源码可选建议勾选✅Qt WebEngine网页组件常用Tools✅MinGW 7.3.0 64-bit✅Qt Creator总结只需要勾选MinGW 编译器 Qt Creator 对应版本库即可。4. 同意协议勾选I have read and agree...→ 点击Next开始安装。安装时间约 10~20 分钟取决于电脑性能。五、环境变量配置可选推荐配置配置后可在命令行使用 qmake、编译器等工具右键此电脑→ 属性 → 高级系统设置 → 环境变量在系统变量中找到Path→ 编辑添加以下 2 条路径根据自己安装路径修改plaintextD:\Qt\Qt5.15.2\5.15.2\mingw73_64\bin D:\Qt\Qt5.15.2\Tools\mingw730_64\bin点击确定保存配置。验证环境是否配置成功按下Win R→ 输入cmd打开命令行输入命令bash运行qmake -v g -v出现版本信息说明配置成功。六、启动 Qt Creator 并创建第一个项目1. 启动 IDE安装完成后桌面会生成Qt Creator快捷方式双击打开。2. 创建新项目点击Create Project选择Application → Qt Widgets Application→ Choose设置项目名称和路径无中文、无空格类名默认MainWindow即可 → Next构建套件选择选择Desktop Qt 5.15.2 MinGW 64-bit点击Finish完成创建3. 编译并运行项目点击左侧运行按钮 ▶或按 CtrlR等待编译完成弹出空白窗口窗口正常显示 →Qt 环境搭建成功七、常见问题与解决方法1. 安装时报错路径包含中文 / 空格解决卸载重装安装路径纯英文。2. 构建套件 (Kit) 显示红色感叹号原因编译器未配置解决Tools → Options → Kits → 选择对应 Kit → 编译器选择 MinGW 7.3.03. 运行报错缺少 dll 文件解决重新配置环境变量或使用windeployqt工具打包依赖。4. 中文乱码解决代码文件保存为UTF-8Qt Creator 中Tools → Options → Text Editor → Behavior → File Encoding 选择 UTF-8八、总结本文完成了Qt 下载、安装、组件选择系统环境变量配置Qt Creator 初始化 第一个项目测试常见问题快速解决搭建完成后即可开始 Qt 桌面应用、嵌入式界面、工控软件等开发工作。总结Qt 安装路径严禁中文、空格新手优先选Qt 5.15.2 MinGW 64 位核心组件Qt 版本库 MinGW 编译器 Qt Creator环境配置完成后创建 Widgets 项目运行成功即代表搭建完成遇到报错优先检查路径、编译器选择、环境变量如果本文对你有帮助欢迎点赞、收藏、评论如有疑问或补充欢迎在评论区交流探讨日常深耕嵌入式、物联网、协议开发相关技术有技术答疑、项目合作、毕设指导需求均可私信私聊