VS Code配置tasks.json后仍无法构建Qt qmake Release版本

在Ubuntu 24.04 LTS系统上使用Visual Studio Code 1.103.0，基于Qt qmake而非CMake开发项目。通过<Ctrl+Shift+D>选择「Launch Pegs (Release)」启动配置后，IDE始终仅生成Debug版本，无法构建并运行Release版本。手动执行bash脚本的Release构建步骤可正常工作，但需要IDE遵循配置选择执行。

以下是当前配置文件内容：

launch.json #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Pegs (Debug)",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/debug/Pegs",
      "preLaunchTask": "Build Debug",
      "cwd": "${workspaceFolder}",
      "MIMode": "gdb",
      "stopAtEntry": false,
      "args": []
    },
    {
      "name": "Launch Pegs (Release)",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/release/Pegs",
      "preLaunchTask": "Build Release",
      "cwd": "${workspaceFolder}",
      "MIMode": "gdb",
      "stopAtEntry": false,
      "args": []
    }
  ]
}

tasks.json #

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Build Debug",
      "type": "shell",
      "command": "echo Debug && sleep 1 && qmake Pegs.pro CONFIG+=debug && make",
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": []
    },
    {
      "label": "Build Release",
      "type": "shell",
      "command": "echo Release && sleep 1 && qmake Pegs.pro CONFIG+=release && make",
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "group": {
        "kind": "build"
      },
      "problemMatcher": []
    },
    {
      "label": "releaseBuildRun",
      "type": "shell",
      "command": "${workspaceFolder}/releaseBuildRun.sh",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always"
      },
      "group": {
        "kind": "none"
      }
    }
  ]
}

Pegs.pro #

CONFIG += c++17

SOURCES += src/main.cpp

QT += core gui
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

CONFIG(debug, debug|release) {
    DESTDIR = build/debug
    OBJECTS_DIR = build/debug/obj
    MOC_DIR = build/debug/moc
    RCC_DIR = build/debug/rcc
    UI_DIR = build/debug/ui
} else {
    DESTDIR = build/release
    OBJECTS_DIR = build/release/obj
    MOC_DIR = build/release/moc
    RCC_DIR = build/release/rcc
    UI_DIR = build/release/ui
}

# Default to debug if no mode is specified
!CONFIG(release):!CONFIG(debug) {
    CONFIG += debug
}

问题核心是qmake缓存旧配置、构建残留文件干扰，以及CONFIG参数的优先级问题，可通过以下步骤修复：

1. 清理构建残留文件
   qmake生成的Makefile会缓存之前的配置，需在构建前清理旧文件。修改tasks.json中的构建命令：

   • 「Build Debug」的command改为：

     echo Debug && sleep 1 && make clean && qmake Pegs.pro CONFIG-=release CONFIG+=debug && make
     

   • 「Build Release」的command改为：

     echo Release && sleep 1 && make clean && qmake Pegs.pro CONFIG-=debug CONFIG+=release && make
     

2. 强制切换CONFIG模式
   使用CONFIG-=debug先移除Debug模式，再追加CONFIG+=release，避免qmake因缓存保留旧配置。

3. 验证任务绑定与单独执行
   打开VS Code任务面板（<Ctrl+Shift+B>），手动运行「Build Release」，确认是否生成build/release/Pegs文件，排除启动配置与任务的绑定问题。

4. 取消默认构建任务干扰
   当前「Build Debug」是默认构建任务（isDefault: true），若IDE自动触发默认构建，可能干扰Release流程。可删除Debug任务中的isDefault: true配置，确保仅执行预启动指定的任务。

内容的提问来源于stack exchange，提问作者Alex Sokolek