如何在VS Code中为C++ SDL2项目配置Debug与Release构建任务

现有Debug配置解析 #

VS Code的tasks.json是自定义执行任务的配置文件，你现有配置的结构和参数都是合理的，各字段含义如下：

• 顶层version：配置文件的规范版本号，固定为2.0.0即可
• 顶层tasks数组：每一个对象对应一个独立的可执行任务，你现有数组里就是Debug构建任务
• 任务内各参数说明：
  • type：任务类型，shell表示该任务会在系统终端中执行命令
  • label：任务的显示名称，会出现在VS Code的任务选择列表中
  • command：要执行的程序路径，这里对应你安装的Mingw工具链的g++编译器
  • args：传递给g++的编译参数，现有参数符合SDL2在Mingw环境下的编译要求：
    • -g：生成调试符号，仅Debug版本需要，供gdb调试器读取调试信息
    • src\\*.cpp：指定编译src目录下所有cpp源文件
    • -o bin\\debug\\main.exe：指定输出的可执行文件存储路径
    • -IC:/SDL2/include：指定头文件搜索路径，让编译器能找到SDL2的头文件
    • -LC:/SDL2/lib：指定库文件搜索路径，让链接器能找到SDL2的预编译库
    • -lmingw32、-lSDL2main、-lSDL2：按顺序链接依赖库，是Mingw下SDL2的标准链接顺序，不可随意调换
    • -mwindows：生成GUI程序，运行时不会弹出黑色控制台窗口，如果你需要控制台打印调试信息可以移除该参数
  • options.cwd：任务执行的工作目录，${workspaceFolder}是VS Code内置变量，指代当前打开的工作区根目录
  • problemMatcher：捕获编译器输出的错误信息，映射到VS Code的问题面板，$gcc是内置的gcc错误匹配规则，无需修改
  • group：任务分组，这里归到build构建组，且设为默认构建任务，按Ctrl+Shift+B会默认执行该任务

新增Release构建配置操作步骤 #

Release版本仅需要调整编译参数、输出路径和任务标识即可，直接在tasks数组中新增一个任务对象，修改后的完整tasks.json如下：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "SDL2 Debug",
            "command": "C:\\msys64\\mingw64\\bin\\g++.exe",
            "args": [
                "-g",
                "src\\*.cpp",
                "-o",
                "bin\\debug\\main.exe",
                "-IC:/SDL2/include",
                "-LC:/SDL2/lib",
                "-lmingw32",
                "-lSDL2main",
                "-lSDL2",
                "-mwindows"            
            ],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "SDL2 Debug构建任务"
        },
        {
            "type": "shell",
            "label": "SDL2 Release",
            "command": "C:\\msys64\\mingw64\\bin\\g++.exe",
            "args": [
                "-O2",
                "-s",
                "src\\*.cpp",
                "-o",
                "bin\\release\\main.exe",
                "-IC:/SDL2/include",
                "-LC:/SDL2/lib",
                "-lmingw32",
                "-lSDL2main",
                "-lSDL2",
                "-mwindows"            
            ],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "SDL2 Release发布构建任务"
        }
    ]
}

Release版本的调整点说明：

1. 把Debug版本的-g参数替换为-O2，这是最常用的发布版优化等级，兼顾运行效率和编译速度，也可以根据需求换成-O3（更高等级优化）、-Os（优先优化体积）
2. 新增-s参数，会删除可执行文件中的调试符号和冗余信息，大幅缩小exe体积
3. 输出路径改为bin\\release\\main.exe，和Debug版本的文件分开存放
4. 任务标签改为SDL2 Release方便区分，不设为默认构建任务

使用时按Ctrl+Shift+P，输入Tasks: Run Build Task，在弹出的列表中选择SDL2 Release即可执行发布版构建。

相关学习要点 #

• G++编译参数：可直接在Mingw终端执行g++ --help查看所有参数的详细说明，按需调整优化选项
• VS Code任务配置：可在VS Code内置文档中搜索tasks 配置查看所有内置变量、配置规则的说明
• SDL2编译规则：SDL2官方源码包的docs目录下有Mingw平台的编译说明，你现有使用的链接顺序、参数都符合官方要求，没有问题

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