VSCode 1.80+ 已彻底移除 Gruntfile.js 自动任务发现，Grunt 任务必须手动配置在工作区根目录的 .vscode/tasks.json 中，且 command 需显式指定路径（如 ./node_modules/.bin/grunt），type 统一设为 "shell"，后台任务须同时设 "isBackground": true 和 "problemMatcher": []。
VSCode 1.80+ 版本起，Gruntfile.js 不再被自动识别为任务来源——你不会在 Tasks: Run Task 列表里看到任何 grunt 任务，这不是配置问题，是 VSCode 主动移除了该能力。
Grunt 任务在 Tasks: Run Task 里不显示的真正原因
很多人花时间重装 grunt-cli、检查 PATH、换插件、清缓存……全无意义。VSCode 自 1.80 起只认两种任务来源：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。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 只本地安装了
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（截至 2026 年 6 月 12 日）默认输出不满足匹配规则。
立即学习“前端免费学习笔记（深入）”；
- 必须同时设置
"isBackground": true和"problemMatcher": [] - 若想保留错误捕获，需自定义
problemMatcher并确保它能匹配grunt watch的实际启动日志（通常含Waiting...或Completed in） - 后台任务无法通过快捷键终止，只能在终端面板点击「垃圾桶」图标或右键选择「Terminate Task」
最易被忽略的一点：VSCode 对 Grunt 的支持已完全退化为“纯命令行封装”，不再有语义感知。哪怕 Gruntfile.js 里定义了 20 个任务，你也得在 tasks.json 里为每个想用的任务单独写一条配置——没有捷径，也没有自动发现。
