Jacob's 百宝箱

Appearance

可以的。VSCode 本身不能直接编译 Qt，但通过安装官方插件和配置工具链，完全可以用来编写、编译和调试 Qt 程序。

下面是具体的配置步骤，以及它和官方 IDE Qt Creator 的对比，供你参考。

⚙️ 配置步骤 ​

将 VSCode 配置成 Qt 开发环境主要分三步：

  1. 安装必备软件

    • 安装 VSCode：从官网下载安装。
    • 安装 Qt：从 Qt 官网下载并安装，推荐勾选 MinGW 或 MSVC 编译器。
    • 安装 CMake：从官网下载安装，并将 bin 目录添加到系统 PATH 环境变量。
    • 安装编译器：若安装 Qt 时未选，可单独安装 MinGW-w64（Windows）或 Xcode（macOS）。

  2. 安装 VSCode 插件 在 VSCode 扩展商店（Ctrl+Shift+X）搜索并安装以下插件：

    • Qt Extension Pack (The Qt Company)：官方插件包，会同时安装 C++、CMake 等必要工具。
    • C/C++ (Microsoft)：提供代码补全和调试支持。

  3. 配置并运行项目

    • 打开项目：在 VSCode 中打开包含 CMakeLists.txt 的 Qt 项目文件夹。
    • 配置 Qt 路径：按 Ctrl+Shift+P，运行命令 Qt: Register Qt installation 并选择你的 Qt 安装路径。
    • 选择 CMake Kit：运行 Qt: Scan for kits，然后在 VSCode 底部状态栏选择一个匹配的 CMake Kit（如 MinGW 或 MSVC）。
    • 构建与运行：点击底部状态栏的“Build”按钮，或按 F5 直接运行和调试。

配置方案：MSVC 编译 ​

第一步：安装 Visual Studio（2019 或 2022） ​

备注：VS2019 和 VS2022 都可以使用

安装步骤 ​

  1. 下载 Visual Studio 2022：https://visualstudio.microsoft.com/downloads/

  2. 运行安装器，勾选：

    • 使用 C++ 的桌面开发
      • MSVC v143 - VS 2022 C++ x64/x86 生成工具
      • Windows 11 SDK（或 Windows 10 SDK）
      • C++ ATL

  3. 等待安装完成

验证安装 ​

重要：必须用 Developer Command Prompt，不是普通 CMD/PowerShell

打开方式：开始菜单搜索 Developer Command Prompt for VS 2022（或 2019）

bash
# 验证 cl.exe 存在
where cl

# 验证 MSVC 版本
cl.exe

# 验证 Windows SDK
dir "C:/Program Files (x86)/Windows Kits/10/Include"

如果 where cl 无输出：

  • 确认是否在 Developer Command Prompt 中执行
  • 打开 Visual Studio Installer → 修改 → 确认「使用 C++ 的桌面开发」已勾选并安装

第二步：下载并安装 Qt 5.15.2 MSVC 版本 ​

安装步骤 ​

  1. 下载 Qt 5.15.2：https://download.qt.io/archive/qt/5.15/5.15.2/

  2. 运行安装器 qt-opensource-windows-x86-5.15.2.exe，使用邮箱注册或跳过

  3. 安装选项选择：

    • Qt 5.15.2
    • MSVC 2019 64-bit（必须是 MSVC，不是 MinGW）
    • Qt Creator（可选）

  4. 安装完成后，将 Qt 添加到系统 PATH：

    • 默认安装路径：C:\Qt\5.15.2\msvc2019_64\bin
    • 或你的安装路径：D:\ProgramData\Qt\5.15.2\msvc2019_64\bin

    重要：添加到系统 PATH 后，必须完全重启 VSCode 才能生效！

    VSCode 继承了启动时的环境变量快照，运行时修改系统 PATH 不会自动生效。

    两种方案：

    1. 完全重启 VSCode（退出所有窗口，再重新打开）
    2. 在 VSCode 终端内临时设置 PATH：
      cmd
      set PATH=D:\ProgramData\Qt\5.15.2\msvc2019_64\bin;%PATH%

验证安装 ​

打开 Developer Command Prompt for VS 2022，执行：

cmd
qmake --version

预期输出：

QMake version 3.1
Using Qt version 5.15.2

如果 qmake 找不到：

  1. 确认 PATH 中包含 Qt 的 bin 目录路径
  2. 必须完全重启 VSCode（退出所有窗口再打开）
  3. 或使用完整路径验证：
    cmd
    D:\ProgramData\Qt\5.15.2\msvc2019_64\bin\qmake.exe --version

第三步：验证 Qt MSVC 环境 ​

cmd
# 验证 Qt 安装
qmake --version
# 输出: QMake version 3.1, Using Qt version 5.15.2

# 验证 MSVC
cl.exe --version

第三步：VSCode 终端配置 ​

VSCode 已配置内置终端 MSVC x64，打开后自动初始化 MSVC + Qt 环境，无需手动配置 tasks.json。

1. 安装扩展 ​

  • C/C++ (Microsoft)

2. 配置 c_cpp_properties.json ​

json
{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${default}",
                "D:/ProgramData/Qt/5.15.2/msvc2019_64/include",
                "D:/ProgramData/Qt/5.15.2/msvc2019_64/include/QtCore",
                "D:/ProgramData/Qt/5.15.2/msvc2019_64/include/QtGui",
                "D:/ProgramData/Qt/5.15.2/msvc2019_64/include/QtWidgets",
                "D:/ProgramData/Qt/5.15.2/msvc2019_64/include/Qsci"
            ],
            "compilerPath": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.37.32822/bin/Hostx64/x64/cl.exe",
            "cppStandard": "c++17"
        }
    ],
    "version": 4
}

3. 编译 ​

按 Ctrl+` 打开终端，直接执行：

cmd
qmake -spec win32-msvc CONFIG+=release LogAnalyzer.pro
nmake

🤔 VSCode vs. Qt Creator ​

你可能会好奇，用 VSCode 和 Qt 官方 IDE 有何不同？这里有个直观的对比：

特性VS CodeQt Creator
启动与运行轻量级，启动和响应速度快，资源占用相对较低。功能集成度高，启动稍慢，资源占用相对较高。
配置复杂度需要手动安装插件、配置 CMake 和编译器路径，初始设置稍繁琐。开箱即用，自动识别 Qt 版本和编译器，无需额外配置。
Qt 专用工具官方插件提供了创建项目/文件的基本功能，但无法直接使用Qt Designer进行可视化界面设计。深度集成 Qt Designer、Qt Quick Designer、帮助文档等，开发和调试体验更无缝。
主要优势通用性强，可通过插件支持多种编程语言和框架，适合需要统一工具链的多语言开发者。专注于 Qt 开发，功能全面、稳定可靠，是官方推荐的 Qt 开发环境，对新手更友好。

💎 总结与建议 ​

总的来说，你可以根据自己的情况来选择：

  • 如果你偏好轻量级、可高度定制的编辑器，或者需要在同一环境下开发多种技术栈的项目，那么 VSCode 是一个很好的选择。
  • 如果你是 Qt 开发新手，或者非常依赖 Qt Designer 等可视化工具进行界面设计，那么 Qt Creator 依然是更省心、更专业的选择。

目前我的能力暂时还无法生成图片或图表，只能通过文字描述来提供信息。希望这些文字对比能帮你理清思路。如果你在配置过程中遇到具体问题，可以随时再问我。