Linux下VSCode编译C++任务报错，手动执行命令却正常

问题场景 #

在Linux环境下用VSCode编译C++，.vscode/tasks.json配置了如下编译任务：

{
"tasks": [
    {
        "type": "cppbuild",
        "label": "C/C++: g++ build active file",
        "command": "/usr/bin/g++",
        "args": [
            "-fdiagnostics-color=always",
            "-g",
            "${fileDirname}/*.cpp",
            "-o",
            "${fileDirname}/${fileBasenameNoExtension}"
        ],
        "options": {
            "cwd": "${fileDirname}"
        },
        "problemMatcher": [
            "$gcc"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "detail": "Task generated by Debugger."
    }
],
"version": "2.0.0"
}

点击运行按钮执行任务时出现报错：

Starting build...
/usr/bin/g++ -fdiagnostics-color=always -g    
     '/some/path/*.cpp' -o /some/path/main

cc1plus: fatal error: /some/path/*.cpp: No such file or directory

compilation terminated.
Build finished with error(s).

但手动在终端执行不带引号的相同命令却能成功编译：

/usr/bin/g++ -fdiagnostics-color=always -g /some/path/*.cpp -o /some/path/main

原因分析 #

VSCode的任务系统默认会把args数组里的每个元素当作独立的字面量参数传递给命令，不会让shell解析通配符*.cpp。这导致g收到的是/some/path/*.cpp这个文件名，而非目录下所有cpp文件的列表；而手动执行命令时，终端shell会先将*.cpp展开成实际的文件名列表，再传给g，所以能成功编译。

无法直接设置“不自动添加引号”，因为这是VSCode传递参数的机制——加引号是为了正确处理含空格的路径，核心问题是通配符需要shell的解析支持。

解决方案 #

方案1：开启shell模式 #

在任务配置中添加"shell": true，让VSCode通过shell来执行命令，这样通配符会被自动展开。同时可以简化args中的路径（因为cwd已设为当前文件目录）：

{
"tasks": [
    {
        "type": "cppbuild",
        "label": "C/C++: g++ build active file",
        "command": "/usr/bin/g++",
        "args": [
            "-fdiagnostics-color=always",
            "-g",
            "*.cpp",
            "-o",
            "${fileBasenameNoExtension}"
        ],
        "options": {
            "cwd": "${fileDirname}"
        },
        "problemMatcher": [
            "$gcc"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "detail": "Task generated by Debugger.",
        "shell": true
    }
],
"version": "2.0.0"
}

方案2：直接调用shell执行完整命令 #

将command设为bash，用-c参数包裹完整的编译命令，让shell负责解析通配符：

{
"tasks": [
    {
        "type": "cppbuild",
        "label": "C/C++: g++ build active file",
        "command": "/bin/bash",
        "args": [
            "-c",
            "/usr/bin/g++ -fdiagnostics-color=always -g *.cpp -o ${fileBasenameNoExtension}"
        ],
        "options": {
            "cwd": "${fileDirname}"
        },
        "problemMatcher": [
            "$gcc"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "detail": "Task generated by Debugger."
    }
],
"version": "2.0.0"
}

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