tasks.json中${workspaceFolder}/*.cpp失效，切换${files}可正常构建

问题场景 #

之前使用以下tasks.json配置时，能正常编译工作区所有cpp文件：

{
  "type": "cppbuild",
  "label": "C/C++: g++ build c++ files",
  "command": "/usr/bin/g++",
  "args": [
    "-std=c++17",
    "-fdiagnostics-color=always",
    "-g",
    "${workspaceFolder}/*.cpp",
    "-o",
    "${workspaceFolder}/build/a.out"
  ],
  "options": {
    "cwd": "${fileDirname}"
  },
  "problemMatcher": ["$gcc"],
  "group": {
    "kind": "build",
    "isDefault": true
  },
}

现在构建失败，报错信息为：clang: error: no such file or directory:。将"${workspaceFolder}/*.cpp"替换为"${files}"后，仅能正常编译当前打开的单个文件。

可能原因及解决方案 #

1. 编译器被自动切换为clang #

配置中指定的是g++，但报错出现clang，说明VS Code的C/C++插件可能自动选用了clang作为默认编译器，导致编译逻辑冲突。

• 解决：在VS Code的settings.json中明确指定默认编译器路径：

  "C_Cpp.default.compilerPath": "/usr/bin/g++"
  

  保存后重启VS Code，再尝试构建。

2. 通配符路径解析失败 #

${workspaceFolder}/*.cpp的路径匹配可能因为当前工作目录（cwd）设置为${fileDirname}而失效，或者shell未正确展开通配符。

• 解决：修改tasks.json的options.cwd为工作区根目录，并开启shell模式让通配符生效：

  {
    "type": "cppbuild",
    "label": "C/C++: g++ build all c++ files",
    "command": "/usr/bin/g++",
    "args": [
      "-std=c++17",
      "-fdiagnostics-color=always",
      "-g",
      "*.cpp",
      "-o",
      "./build/a.out"
    ],
    "options": {
      "cwd": "${workspaceFolder}",
      "shell": true
    },
    "problemMatcher": ["$gcc"],
    "group": {
      "kind": "build",
      "isDefault": true
    }
  }
  

  如果需要递归编译所有子目录的cpp文件，将"*.cpp"替换为"**/*.cpp"。

3. 文件路径或权限问题 #

• 先在终端手动执行编译命令，验证是否能正常工作：

  cd 你的工作区路径
  /usr/bin/g++ -std=c++17 -g *.cpp -o build/a.out
  

  如果终端执行失败，检查：
  • 工作区下是否存在cpp文件
  • 文件路径是否包含空格、特殊字符（这类字符会导致通配符解析异常）
  • build目录是否存在（如果不存在，先手动创建mkdir build）

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