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

个人博客：blogs.wurp.top

一、安装准备

1. 系统要求：

   • Windows 10（64 位）
   • 至少 10GB 磁盘空间
   • 内存 ≥ 4GB（推荐 8GB）

2. 下载资源：

   • 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）

二、安装步骤

1. 安装 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（路径中不要有空格）。

2. 安装 VSCode：

   • 运行 VSCode 安装程序，按默认设置完成安装。

3. 安装编译器（如未选 MinGW）：

   • 若使用 MSVC 2013，需提前安装 Visual Studio 2013。

三、配置环境变量

1. 打开 系统设置 → 环境变量 → 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

2. 验证 Qt 安装：

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

四、VSCode 配置

1. 安装扩展：

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

2. 配置 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"
           }
         ]
       }
       

五、创建测试项目

1. 项目结构：

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

2. project.pro 文件：

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

3. 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();
   }
   

六、编译与运行

1. 手动构建：

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

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

   • 运行程序：

     debug\HelloQt.exe
     

2. VSCode 快捷操作：

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

七、常见问题解决

1. qmake 未找到：

   • 检查环境变量 Path 是否包含 Qt 的 bin 目录。
   • 重启 VSCode 使环境变量生效。

2. MSVC 编译错误：

   • 确保已安装 Visual Studio 2013。
   • 在 开始菜单 → VS2013 开发人员命令提示符 中运行 VSCode：

     cd "C:\Path\to\VSCode"
     code .
     

3. 调试器配置错误：

   • 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)
  

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