tasks.json 的 version 字段必须严格为字符串 "2.0.0"，其他如 "2.0" 或 "0.1.0" 会导致 schema 校验失败、任务不生效；command 仅填可执行文件路径，args 以数组形式分离参数，通配符需手动展开或借助构建工具。
tasks.json 的 version 字段必须是 "2.0.0"
VSCode 任务系统只认 "version": "2.0.0"，写成 "2.0"、"2" 或旧版 "0.1.0" 都会导致 tasks 不生效，甚至整个文件被忽略。这不是兼容性问题，而是 schema 校验失败。
常见错误现象：Ctrl+Shift+B 按下后无反应；命令面板里搜不到你定义的 task；终端里提示“无法找到构建任务”。
-
version必须是字符串，且严格等于"2.0.0" - 不要试图用变量或表达式替换它——它不是运行时值，是静态 schema 声明
- 如果从旧项目复制配置，务必检查这一行，尤其注意引号是否为中文全角
command 和 args 分离不当会直接报错
command 是可执行程序路径（如 "g++"、"npm"），args 是它后面的全部参数列表。把参数塞进 command 字符串里（比如写成 "g++ -g main.cpp"）会导致 VSCode 把整串当一个命令名去查找，结果报 Command failed: g++ -g main.cpp 或 The term 'g++ -g main.cpp' is not recognized。
正确做法是：
-
command只填二进制名或绝对路径，例如"D:/mingw-w64/bin/g++.exe"或"tsc" -
args用数组拆开每个词：["-g", "-std=c++17", "${file}", "-o", "out.exe"] - 路径通配符（如
"${workspaceFolder}/src/*.cpp"）在 Windows 下可能不展开，建议改用find或glob工具，或明确列出文件
type 设为 "cppbuild" 时，command 必须指向真实编译器
当 type 是 "cppbuild"（C/C++ 插件推荐类型），VSCode 会做额外校验：它要求 command 对应的可执行文件存在且可执行。如果路径写错、权限不足、或指向了空目录，任务会静默失败——没有错误提示，只是不输出任何东西。
调试方法：
- 在终端里手动运行
command+args的组合，确认能成功编译 - Windows 上注意路径分隔符，
D:mingwing++.exe要写成"D:/mingw/bin/g++.exe"或双反斜杠"D:\mingw\bin\g++.exe" - macOS/Linux 用户若用 Homebrew 安装的
g++，实际路径可能是/opt/homebrew/bin/g++-14，不能只写"g++"（除非 PATH 已确保可用）
多文件项目必须显式指定所有 .cpp 文件或用构建工具
"${workspaceFolder}/src/*.cpp" 在 args 中看似方便，但 VSCode 不会帮你 glob 展开——它只是原样传给编译器。而 MinGW 的 g++ 和大多数 Linux g++ 默认不支持 shell 通配，结果就是编译器报错：找不到名为 "src/*.cpp" 的文件。
可行方案：
- 用
find命令生成文件列表（仅限 macOS/Linux）："command": "sh", "args": ["-c", "g++ -g $(find ${workspaceFolder}/src -name '*.cpp') -I${workspaceFolder}/include -o build/app.exe"] - 改用
make或cmake管理多文件，tasks.json只调用构建工具，而非直连编译器 - 最稳妥：把所有源文件名硬编码进
args，适合小项目，避免路径解析歧义
真正容易被忽略的是：VSCode 的 task 不是 shell 环境，它不做任何预处理——你写的每个 args 元素，都会原封不动作为 argv 传给 command 进程。理解这点，才能避开 80% 的配置失败。
