tasks.json中command路径必须显式指向本地gulp可执行文件：linux/macos用"./node_modules/.bin/gulp"，windows用". ode_modules.bingulp.cmd"；需设"type":"shell"，args为字符串数组，watch任务须清空problemmatcher，调试应直接运行gulp/bin/gulp.js。
tasks.json 里 command 路径写不对，Gulp 就根本启动不了
VSCode 1.80+ 彻底移除了对 gulpfile.js 的自动识别，command 字段必须显式指向本地安装的可执行文件，不能依赖全局命令或 PATH 查找。
- Linux/macOS：用
"./node_modules/.bin/gulp"，注意是斜杠、不是反斜杠 - Windows：用
".\node_modules\.bin\gulp.cmd"（双反斜杠是 JSON 字符串转义必需） - 别写
"gulp"—— 即使全局装了，VSCode 任务系统也不会从 PATH 拿，且"type": "process"在含空格路径下会崩溃 - 统一设
"type": "shell"，避免平台兼容性问题 -
args必须是字符串数组，比如["build"]，不能写成"build"或["--tasks"]（后者会让任务卡住不退出）
watch 任务永远显示“正在运行”，其实是 problemMatcher 在拦路
"isBackground": true 只是告诉 VSCode “这任务不会自己结束”，但默认的 problemMatcher 会等 Finished 'watch' 这类输出才能标记为启动成功——而 gulp watch 根本不输出这个。
- 必须删掉或清空
"problemMatcher"字段（写成[]或直接移除） - 建议加上
"presentation": { "panel": "shared", "clear": true }，防止日志越积越多 -
"group": "build"或"group": "watch"可让任务在命令面板里归类显示 - VSCode 不监听文件变化，真正的 watch 行为仍在 gulp 内部，它只是把 stdout/stderr 接过来展示
想断点调试 gulpfile.js，launch.json 得绕过 gulp-cli 包装层
直接用 gulp 命令跑任务时，实际入口是 node_modules/gulp-cli/index.js，断点打不到你的 gulpfile.js。要调试，得让 Node.js 直接执行 gulp 的核心二进制入口。
-
runtimeExecutable应设为"${workspaceFolder}/node_modules/gulp/bin/gulp.js"（不是gulp-cli的路径） -
args传入任务名，如["default"]，别加--gulpfile参数（VSCode 默认就在项目根目录找） - 确保
gulp是本地安装（npm install --save-dev gulp），否则bin/gulp.js不存在 - 如果用的是 gulp 4+，
gulpfile.js里必须导出函数（module.exports = function() { ... }），不然调试时会报Cannot find module 'gulp'
别信“Gulp Task Runner”插件能帮你注册任务
这类扩展（如 eg2 开发的）只提供侧边栏视图，列出 gulp --tasks 的结果，但它们**不参与 VSCode 任务系统**，不会让任务出现在 Tasks: Run Task 列表里，也不能和 launch.json 调试联动。
- 真正能触发构建、监听、调试的唯一入口是
.vscode/tasks.json和.vscode/launch.json - 验证
gulpfile.js是否有效？终端里直接运行gulp --tasks，能列出任务才说明语法和依赖没问题 - 如果
Tasks: Run Task里没任何 gulp 选项，99% 是因为没配tasks.json，不是插件没装、也不是 gulp 没装好
tasks.json 后，VSCode 不会自动重载任务列表，必须手动触发 Tasks: Run Task（Ctrl+Shift+P），或者关掉再打开命令面板才能看到新任务。
