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

个人博客：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 安装：

bash 复制代码

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 （构建任务）：

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 （调试配置）：

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 文件：

qmake 复制代码

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

main.cpp 文件：

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+```）：

bash 复制代码

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

运行程序：
bash 复制代码
```
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：
  bash 复制代码
```
cd "C:\Path\to\VSCode"
code .
```
调试器配置错误：
- MinGW 用户：在 launch.json 中设置 "miDebuggerPath": "gdb.exe" 的完整路径。
- MSVC 用户：确保使用 "type": "cppvsdbg"。

八、优化建议

使用 CMake （替代 qmake）：

cmake 复制代码

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)

安装 Qt Creator：作为备用调试工具（尤其适用于复杂项目）。