VSCode 1.80+已彻底移除Gruntfile.js自动任务发现，仅支持package.json scripts或手动配置.vscode/tasks.json；文件必须位于工作区根目录下.vscode/tasks.json，且command需显式指定路径（如./node_modules/.bin/grunt），type统一用"shell"，后台任务须同时设"isBackground":true和"problemMatcher":[]。
VSCode 从 1.80 版本起已完全移除对 Gruntfile.js 的自动任务发现能力，你不会在 Tasks: Run Task 列表里看到 grunt: build 这类选项——不是插件没装、不是 Grunt 没装好，而是 VSCode 主动放弃了这个机制。所有 Grunt 任务必须手动配置在 .vscode/tasks.json 中，且路径、类型、后台行为需一一对应，否则任务不可见或静默失败。
Grunt 任务为什么在 Tasks: Run Task 里不显示
常见排查方向全是错的：重装 grunt-cli、检查 PATH、换插件、清缓存……真正原因只有一个：VSCode 不再扫描 Gruntfile.js，它只认两种来源——package.json 里的 scripts（对 npm），或你亲手写的 .vscode/tasks.json（对 Grunt）。没这个文件，就永远没有任务。
- 确认
Gruntfile.js在工作区根目录（不是src/Gruntfile.js） - 终端执行
grunt --tasks能列出任务，说明文件语法和依赖正常 - 别信 “Grunt Task Runner” 扩展能帮你注册任务——它只提供侧边栏视图，不接入 VSCode 任务系统
-
tasks.json必须放在.vscode/下，文件名必须是tasks.json，不能是task.json或tasks.json.bak
command 字段怎么写才跨平台可用
VSCode 默认不走 shell 的 PATH 查找逻辑，command 必须显式指定可执行文件路径，否则 Windows 下会因空格或后缀失败，Linux/macOS 下会报 command not found。
- 只本地安装了
grunt-cli（推荐）：
Linux/macOS："command": "./node_modules/.bin/grunt"
Windows："command": ".\node_modules\.bin\grunt.cmd" - 全局安装了
grunt-cli，可简写为"command": "grunt"，但版本可能与项目不一致 - 绝对不要用
"type": "process"：Windows 下遇到带空格路径（如C:Program Files）会直接崩溃；统一用"type": "shell" -
args必须是字符串数组，例如["build"]，不能写成"build"或["--tasks"]（后者会触发自检但不退出）
如何让 grunt watch 真正后台运行并可终止
"isBackground": true 不是“开启监听”，它只是告诉 VSCode：“这任务不会自己结束，请别等它退出”。如果你只设了这个却没清理 problemMatcher，任务会卡在“正在运行”状态，改了文件也毫无反应——因为 VSCode 默认靠匹配输出文本（比如 Running "watch" task）来判断是否启动成功，而 grunt watch 根本不输出这种信号。
- 必须同时设置
"isBackground": true和"problemMatcher": []（空数组，不能删掉字段） - 建议加
"presentation": { "echo": false, "reveal": "never", "focus": false }减少干扰 - 终止任务用
Tasks: Terminate Running Task（Ctrl+Shift+P），不是关终端 - 若需错误捕获（如
uglify报错跳转），得自定义problemMatcher正则，但绝大多数 Grunt 插件输出格式不标准，慎写
为什么 Ctrl+Shift+B 没反应或跑错任务
Ctrl+Shift+B 默认绑定的是 build 组里的默认任务（"group": "build", "isDefault": true）。如果你的任务没分组、没标默认，或者 label 名含空格/特殊字符，快捷键就失效。
- 确保任务有
"group": "build"，且仅有一个任务带"isDefault": true - label 值尽量用英文+下划线，避免空格（如
"label": "grunt_build"而非"label": "Grunt Build"） - 如果用了
"type": "npm"，script 名必须严格匹配package.json中的 key（大小写、空格都不能错） - Windows 用户跑 PowerShell 脚本，必须显式指定
"shell": { "executable": "pwsh", "args": ["-Command"] }，否则被执行策略拦截
最常被忽略的一点：VSCode 任务系统不继承 shell 的环境变量（比如 nvm 切的 Node 版本、~/.zshrc 里的别名），所以即使你在终端里 grunt --tasks 能跑，tasks.json 里也可能因 Node 版本不一致而失败。用 npx --no-install grunt 替代 command 是更稳的选择。
