当前位置：首页 > news >正文

Qt 5.5 的安装与配置（使用 VSCode编辑）

news 2025/8/18 6:19:39

个人博客：blogs.wurp.top

一、安装准备

系统要求：
- Windows 10（64 位）
- 至少 10GB 磁盘空间
- 内存 ≥ 4GB（推荐 8GB）
下载资源：
- Qt 5.5 离线安装包：
  qt-opensource-windows-x86-msvc2013_64-5.5.1.exe
  （选择 msvc2013_64 或 mingw492_32 版本，此处以 msvc2013_64 为例）
- VSCode：
  Visual Studio Code
- 编译器（二选一）：
  - MinGW 4.9.2（已包含在 Qt 安装包中）
  - Visual Studio 2013（需单独安装，VS2013 Community）

二、安装步骤

安装 Qt 5.5：
- 运行安装程序 qt-opensource-windows-x86-msvc2013_64-5.5.1.exe。
- 登录 Qt 账号
- 组件选择：
  - 勾选 Qt 5.5 → MSVC 2013 64-bit（或 MinGW 4.9.2 32-bit）。
  - 勾选 Tools → Qt Creator 3.5.1（可选，用于调试）。
  - 安装路径：建议 C:\Qt\Qt5.5.1（路径中不要有空格）。
安装 VSCode：
- 运行 VSCode 安装程序，按默认设置完成安装。
安装编译器（如未选 MinGW）：
- 若使用 MSVC 2013，需提前安装 Visual Studio 2013。

三、配置环境变量

打开 系统设置 → 环境变量 → Path：
- 添加 Qt 路径：
  C:\Qt\Qt5.5.1\5.5\msvc2013_64\bin
  （若用 MinGW：C:\Qt\Qt5.5.1\Tools\mingw492_32\bin）
- 添加 VSCode 路径（可选）：
  C:\Users\<用户名>\AppData\Local\Programs\Microsoft VS Code\bin

验证 Qt 安装：

qmake -v
# 应输出：QMake version 3.0 (Qt 5.5.1)

四、VSCode 配置

安装扩展：
- C/C++（Microsoft）
- CMake Tools（Microsoft，用于 CMake 项目）
- Code Runner（Jun Han，快速运行程序）
- Qt Configure（仅当使用 qmake 时）

配置 C++ 环境：

创建 .vscode 文件夹，包含以下文件：

tasks.json（构建任务）：

{"version": "2.0.0","tasks": [{"label": "qmake","type": "shell","command": "qmake","args": ["${workspaceFolder}/project.pro"]},{"label": "make","type": "shell","command": "nmake",        // MSVC 用 nmake// "command": "mingw32-make", // MinGW 用此命令"args": [],"dependsOn": ["qmake"]}]
}

launch.json（调试配置）：

{"version": "0.2.0","configurations": [{"name": "Debug Qt App","type": "cppvsdbg",       // MSVC 调试器// "type": "cppdbg",       // MinGW 调试器"request": "launch","program": "${workspaceFolder}/debug/app.exe", // 可执行文件路径"args": [],"stopAtEntry": false,"cwd": "${workspaceFolder}","environment": [],"preLaunchTask": "make"}]
}

五、创建测试项目

项目结构：

HelloQt/
├── main.cpp
├── project.pro
└── .vscode/├── tasks.json└── launch.json

project.pro 文件：

QT += core gui widgets
TARGET = HelloQt
SOURCES += main.cpp

main.cpp 文件：

#include <QApplication>
#include <QLabel>int main(int argc, char *argv[]) {QApplication app(argc, argv);QLabel label("Hello, Qt 5.5!");label.show();return app.exec();
}

六、编译与运行

手动构建：

打开终端（VSCode 快捷键：Ctrl+`）：

qmake project.pro  # 生成 Makefile
nmake             # MSVC 编译（MinGW 用 mingw32-make）

运行程序：
```
debug\HelloQt.exe
```

VSCode 快捷操作：
- 构建：Ctrl + Shift + B → 选择 make 任务。
- 调试：F5（自动执行构建并启动调试器）。
- 运行：安装 Code Runner 后，右键点击 main.cpp → Run Code。

七、常见问题解决

qmake 未找到：
- 检查环境变量 Path 是否包含 Qt 的 bin 目录。
- 重启 VSCode 使环境变量生效。
MSVC 编译错误：
- 确保已安装 Visual Studio 2013。
- 在 开始菜单 → VS2013 开发人员命令提示符 中运行 VSCode：
```
cd "C:\Path\to\VSCode"
code .
```
调试器配置错误：
- MinGW 用户：在 launch.json 中设置 "miDebuggerPath": "gdb.exe" 的完整路径。
- MSVC 用户：确保使用 "type": "cppvsdbg"。

八、优化建议

使用 CMake（替代 qmake）：

cmake_minimum_required(VERSION 3.5)
project(HelloQt)
set(CMAKE_CXX_STANDARD 11)
find_package(Qt5 COMPONENTS Core Gui Widgets REQUIRED)
add_executable(HelloQt main.cpp)
target_link_libraries(HelloQt Qt5::Core Qt5::Gui Qt5::Widgets)