VSCode 1.80+ 彻底移除 Gruntfile.js 自动任务发现，必须手动配置 .vscode/tasks.json（command 显式指定本地 grunt-cli 路径）和 launch.json（program 指向 bin/grunt、cwd 设为工作区根）才能运行与调试 Grunt 任务。
VSCode 1.80+ 版本已彻底移除对 Gruntfile.js 的自动任务发现，你不会在 Tasks: Run Task 列表里看到任何 Grunt 任务——这不是插件或环境问题，而是 VSCode 主动弃用了该机制。必须手动配置 .vscode/tasks.json 才能运行，调试则需额外配置 launch.json 指向本地 grunt-cli 入口。
tasks.json 必须手动写，且 command 要显式指定路径
VSCode 不再扫描 Gruntfile.js，只认 .vscode/tasks.json（必须位于工作区根目录的 .vscode/ 下，文件名不能是 task.json 或带后缀备份）。command 字段不能依赖系统 PATH，否则 Windows 下因空格或后缀失败，Linux/macOS 下报 command not found：
- 本地安装
grunt-cli（推荐）：
Linux/macOS："command": "./node_modules/.bin/grunt"
Windows："command": ".\node_modules\.bin\grunt.cmd" - 全局安装可简写为
"command": "grunt"，但可能与项目期望的grunt版本不一致 -
type必须为"shell"；"process"在 Windows 上遇到带空格路径（如C:Program Files）会直接崩溃 -
args是字符串数组，例如["build"]，不能写成"build"或["--tasks"]（后者触发自检但不退出）
让 grunt watch 真正后台运行并可终止
"isBackground": true 只是告诉 VSCode “这任务不会自己结束”，不是开启监听。若只设这个而没清理 problemMatcher，任务会卡在“正在运行”状态，改文件也无反应——因为 VSCode 默认靠匹配输出（如 Running "watch" task）判断启动成功，而 grunt 的输出格式不匹配默认 matcher：
- 必须同时设置
"isBackground": true和"problemMatcher": [] - 不要用
$grunt这类内置 problemMatcher，它已过时且不生效 - 后台任务执行后，可在终端面板右上角点击「终止任务」按钮停止，或用快捷键
Ctrl+Shift+P→Tasks: Terminate Running Task
调试 Gruntfile.js 需直接 attach 到 grunt-cli 入口
VSCode 原生支持 Node.js 调试，但不能直接调试 Gruntfile.js —— 它是被 grunt-cli 动态加载执行的。正确方式是让调试器启动 node 运行 grunt-cli 的 bin 文件，并把工作目录指向项目根：
- 在
.vscode/launch.json中添加配置："program": "${workspaceFolder}/node_modules/grunt-cli/bin/grunt"（注意路径是/bin/grunt，不是/lib/cli.js） -
"cwd": "${workspaceFolder}"必须显式设置，否则grunt找不到Gruntfile.js - 断点只能下在
Gruntfile.js里（比如grunt.initConfig或任务定义处），node_modules内部代码无法可靠命中 - 启动调试前确保
grunt已本地安装，且Gruntfile.js语法正确（终端执行grunt --tasks应能列出任务）
别信“Grunt Task Runner”这类扩展能注册任务
这类扩展（如旧版 Grunt Task Runner）只提供侧边栏视图，完全不接入 VSCode 的任务系统，你在 Tasks: Run Task 里依然看不到任何选项。真正起作用的只有两件事：.vscode/tasks.json 和 .vscode/launch.json。其他所有排查方向——重装 grunt-cli、检查 PATH、换插件、清缓存——都是徒劳的。复杂点在于：Grunt 本身不提供标准调试协议，你得靠 Node.js 的调试机制绕一层；容易被忽略的是 cwd 和 program 路径的组合必须精确匹配本地 node_modules 结构，差一个斜杠或层级就静默失败。
