Qt 入门 01-02： 开发环境搭建指南

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 同步视频

Qt 入门 01-02： 开发环境搭建指南

在 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 下载

1. 浏览器搜索 VS2019，进入微软官网。

2. 页面向下滚动，找到 较早的下载项。

3. 在列表中选择 2019 版本 下载即可。

2. Qt 在线安装器（4.3.0 稳定版）

1. 搜索 Qt，进入 Qt Archive / Desktop Archive。

2. 向上找到 online stores 目录。

3. 选择 4.3.0-1 版本下载（避开最新版，兼容性更稳）。

4. 如需长期支持版：可选择 Qt 5.12 离线包（约 3.7G），5.14 同样支持离线。

3. VS Qt 插件（vsaddin 2.8.1）

在插件下载页选择 VS2019 专用 2.8.1 版本，一键获取。

---

🛠️ 三、VS2019 安装｜必选组件不踩坑

1. 双击安装包 → 允许权限 → 等待加载。

2. 核心勾选（只选这 3 项）：

   • 使用 C++ 桌面开发

   • 通用 Windows 平台开发

   • 下方扩展相关项

3. 安装模式：选择 下载时安装（速度更快）。

4. 路径建议：默认 C 盘，后续环境配置更省心。

5. 安装完成启动：

   • 跳过登录 → 以后再说

   • 开发设置：微软 C++

   • 主题：推荐深色

   • 启动后关闭 VS，准备装 Qt。

---

📦 四、Qt 5.15.2 安装｜组件勾选清单

1. 运行 Qt 安装器，登录 Qt 账号（官网免费注册）。

2. 选择 个人开发，公司信息留空。

3. 安装位置：默认 C 盘（所需空间约 20--30G）。

4. 安装类型：自定义安装。

5. 必勾组件（关键）：

   • Qt 5.15.2

   • MSVC 2019 32 位 + 64 位（与 VS 匹配）

   • Qt Charts / Data 模块

   • Web 引擎（混合开发必备）

   • WebGL 相关组件

6. 可选项：源码按需勾选，节约空间可跳过。

7. 下一步 → 同意 → 开始安装（耗时较久，耐心等待⏳）。

8. 安装完成：取消启动 Qt Creator，直接点完成。

---

🔌 五、VS Qt 插件安装｜打通两者桥梁

1. 关闭所有 VS 进程（任务管理器彻底结束）。

2. 双击 qtvsaddin 2.8.1。

3. 插件自动检测 VS2019 → 点击 Install。

4. 安装完成 → Close。

5. 把 Qt、VS2019 快捷方式发送到桌面，方便使用。

---

🚀 六、环境验证｜两种方式跑通项目

方式 1：Qt Creator 创建并运行

1. 新建 Qt Widget Application。

2. 路径：C 盘新建文件夹，命名如 QtProject。

3. 项目名：Demo01 → 基类选择 QWidget。

4. 编译系统：推荐 qmake（后期常用）。

5. 构建套件：选择 MSVC 2019 32 bit。

6. 设计 UI：拖拽按钮、输入框、进度条、布局。

7. Ctrl+S 保存 → 点击运行，弹出窗口即成功🎉

方式 2：VS2019 创建 Qt 项目

1. 新建项目 → 语言选 C++ → 搜索 Qt。

2. 选择 Qt Widget Application，路径自定义。

3. 若创建失败：

   • 先建控制台项目

   • 扩展 → Qt 配置 → 添加 Qt Version

   • 路径指向：C:Qt5.15.2msvc2019

4. UI 文件打开报错解决：

   • 右键 UI 文件 → 打开方式

   • 选择：C:QtToolsQtCreatorbinqtcreator.exe

   • 设为默认，即可正常编辑。

5. 修改 UI → 保存 → 本地调试运行，界面正常即配置完成。

---

✅ 七、总结｜一套环境，全程顺畅

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