Qt 入门 01-02: 开发环境搭建指南
- [Bilibili 同步视频](#Bilibili 同步视频)
- [🔧 一、环境总览|先明确三件事](#🔧 一、环境总览|先明确三件事)
- [📥 二、安装包精准下载|不迷路版本](#📥 二、安装包精准下载|不迷路版本)
-
- [1. Visual Studio 2019 下载](#1. Visual Studio 2019 下载)
- [2. Qt 在线安装器(4.3.0 稳定版)](#2. Qt 在线安装器(4.3.0 稳定版))
- [3. VS Qt 插件(vsaddin 2.8.1)](#3. VS Qt 插件(vsaddin 2.8.1))
- [🛠️ 三、VS2019 安装|必选组件不踩坑](#🛠️ 三、VS2019 安装|必选组件不踩坑)
- [📦 四、Qt 5.15.2 安装|组件勾选清单](#📦 四、Qt 5.15.2 安装|组件勾选清单)
- [🔌 五、VS Qt 插件安装|打通两者桥梁](#🔌 五、VS Qt 插件安装|打通两者桥梁)
- [🚀 六、环境验证|两种方式跑通项目](#🚀 六、环境验证|两种方式跑通项目)
-
- [方式 1:Qt Creator 创建并运行](#方式 1:Qt Creator 创建并运行)
- [方式 2:VS2019 创建 Qt 项目](#方式 2:VS2019 创建 Qt 项目)
- [✅ 七、总结|一套环境,全程顺畅](#✅ 七、总结|一套环境,全程顺畅)
Bilibili 同步视频
在 Windows 平台进行 C++/Qt 开发,一套稳定、适配的开发环境 是效率的起点。本文基于实战流程,完整拆解 VS2019 + Qt 5.15.2 + Qt VS Tools 2.8.1 安装、配置、项目创建与运行全流程,照着做一次成功✅
🔧 一、环境总览|先明确三件事
-
系统:Windows 10 / Windows 11 x64
-
核心组件:VS2019 → Qt 5.15.2 → VS Qt 插件(vsaddin 2.8.1)
-
版本要点:Qt 5.15 及以后仅支持在线安装,5.15 之前可离线安装,本文选用稳定兼容组合。
📥 二、安装包精准下载|不迷路版本
1. Visual Studio 2019 下载
-
浏览器搜索 VS2019,进入微软官网。
-
页面向下滚动,找到 较早的下载项。
-
在列表中选择 2019 版本 下载即可。
2. Qt 在线安装器(4.3.0 稳定版)
-
搜索 Qt,进入 Qt Archive / Desktop Archive。
-
向上找到 online stores 目录。
-
选择 4.3.0-1 版本下载(避开最新版,兼容性更稳)。
-
如需长期支持版:可选择 Qt 5.12 离线包(约 3.7G),5.14 同样支持离线。
3. VS Qt 插件(vsaddin 2.8.1)
在插件下载页选择 VS2019 专用 2.8.1 版本,一键获取。
🛠️ 三、VS2019 安装|必选组件不踩坑
-
双击安装包 → 允许权限 → 等待加载。
-
核心勾选(只选这 3 项):
-
使用 C++ 桌面开发
-
通用 Windows 平台开发
-
下方扩展相关项
-
-
安装模式:选择 下载时安装(速度更快)。
-
路径建议:默认 C 盘,后续环境配置更省心。
-
安装完成启动:
-
跳过登录 → 以后再说
-
开发设置:微软 C++
-
主题:推荐深色
-
启动后关闭 VS,准备装 Qt。
-
📦 四、Qt 5.15.2 安装|组件勾选清单
-
运行 Qt 安装器,登录 Qt 账号(官网免费注册)。
-
选择 个人开发,公司信息留空。
-
安装位置:默认 C 盘(所需空间约 20--30G)。
-
安装类型:自定义安装。
-
必勾组件(关键):
-
Qt 5.15.2
-
MSVC 2019 32 位 + 64 位(与 VS 匹配)
-
Qt Charts / Data 模块
-
Web 引擎(混合开发必备)
-
WebGL 相关组件
-
-
可选项:源码按需勾选,节约空间可跳过。
-
下一步 → 同意 → 开始安装(耗时较久,耐心等待⏳)。
-
安装完成:取消启动 Qt Creator,直接点完成。
🔌 五、VS Qt 插件安装|打通两者桥梁
-
关闭所有 VS 进程(任务管理器彻底结束)。
-
双击 qtvsaddin 2.8.1。
-
插件自动检测 VS2019 → 点击 Install。
-
安装完成 → Close。
-
把 Qt、VS2019 快捷方式发送到桌面,方便使用。
🚀 六、环境验证|两种方式跑通项目
方式 1:Qt Creator 创建并运行
-
新建 Qt Widget Application。
-
路径:C 盘新建文件夹,命名如
QtProject。 -
项目名:
Demo01→ 基类选择 QWidget。 -
编译系统:推荐 qmake(后期常用)。
-
构建套件:选择 MSVC 2019 32 bit。
-
设计 UI:拖拽按钮、输入框、进度条、布局。
-
Ctrl+S 保存 → 点击运行,弹出窗口即成功🎉
方式 2:VS2019 创建 Qt 项目
-
新建项目 → 语言选 C++ → 搜索 Qt。
-
选择 Qt Widget Application,路径自定义。
-
若创建失败:
-
先建控制台项目
-
扩展 → Qt 配置 → 添加 Qt Version
-
路径指向:
C:Qt5.15.2msvc2019
-
-
UI 文件打开报错解决:
-
右键 UI 文件 → 打开方式
-
选择:
C:QtToolsQtCreatorbinqtcreator.exe -
设为默认,即可正常编辑。
-
-
修改 UI → 保存 → 本地调试运行,界面正常即配置完成。
✅ 七、总结|一套环境,全程顺畅

按 VS2019 → Qt → 插件 的顺序安装,组件精准勾选,路径默认 C 盘,就能在 Windows 上搭建稳定、低冲突的 Qt C++ 开发环境。无论是用 Qt Creator 快速设计 UI,还是在 VS 中编写逻辑,都能流畅运行,为后续项目开发打下坚实基础💻