Sublime Text 4 必须通过 wbond 维护的 Gulp 插件调用项目本地 gulp（node_modules/.bin/gulp），不支持全局安装、npx 或 package.json scripts；需在项目根目录执行 npm install --save-dev gulp gulp-cli，确保 gulpfile.js 在当前文件所在目录或其父级路径中，且插件右下角显示“Gulp”字样表示加载成功。
Sublime Text 本身不带 Gulp 支持，必须通过 Gulp 插件（wbond 维护版）调用你项目里已安装的本地 gulp 可执行文件；它不认全局 gulp-cli、不走 npx、也不读 package.json 的 scripts。装错位置或路径没对上，就会卡在 command not found 或 No tasks found。
确认项目中存在可执行的 gulp
插件只检查 node_modules/.bin/gulp（Linux/macOS）或 node_modules\.bin\gulp.cmd（Windows），完全忽略 npm install -g gulp-cli。
- 必须在项目根目录运行：
npm install --save-dev gulp gulp-cli - 验证是否生成可执行文件：
ls node_modules/.bin/gulp（macOS/Linux）或dir node_modules\.bin\gulp.cmd（Windows） - 用
pnpm？加.pnpmrc文件，内容为"preferSymlink": true，否则软链可能失效 - 用
yarnv3+？默认启用 PnP 模式，.bin不生成，建议改用pnpm或降级到 yarn v1
安装后右下角没出现 Gulp 字样
这表示插件根本没加载成功，不是配置问题，是兼容性或依赖缺失。
- 插件名就是
Gulp，不是SublimeGulp或SublimeLinter-gulp - 仅兼容 Sublime Text 4（API v4+），ST3 用户会看到
ImportError: No module named 'sublime' - 按
Ctrl+`打开控制台，搜no module named 'sublime'—— 出现即说明版本不匹配 -
Package Control必须先就位；如果Ctrl+Shift+P里搜不到Package Control: Install Package，得手动装官方 Python 安装脚本
运行时提示 No tasks found 或找不到 gulpfile.js
插件默认只从当前打开的文件所在目录开始，向上逐级搜索 gulpfile.js，不会扫描整个工作区，也不识别多根工作区中的子项目根。
立即学习“前端免费学习笔记（深入）”；
- 确保至少有一个已打开的文件属于你的项目根目录（比如直接打开
package.json或src/index.js） - 如果项目结构是
monorepo/packages/web/，而你只打开了packages/web/src/下的文件，插件大概率找不到packages/web/gulpfile.js - 手动指定路径：按
Ctrl+Shift+P→ 输入Gulp: Set Gulp File Path→ 填入绝对路径，例如/Users/you/project/gulpfile.js -
exports.default被识别为default；但exports['build:css']这类带冒号或空格的命名，插件无法调用（不支持引号语法）
任务运行失败但输出面板只显示 Task failed
插件默认捕获 stdout/stderr 并显示在面板里，但如果 task 内部抛出未处理的 Promise 拒绝、或调用 process.exit(1)，面板可能只显示 Task failed 而无细节。
- 检查
gulpfile.js中任务是否用了async函数但没return或await所有异步操作 - 避免在任务里直接写
process.exit(1)；改用throw new Error('xxx')让 gulp 正确捕获 - 如果用了
gulp.series或gulp.parallel，确保每个子任务都正确返回 stream / promise / callback
最常被忽略的是：插件行为边界极窄——它不帮你装 gulp，不递归找 gulpfile.js，也不适配 PnP 或 symlink 异常；所有环节都得手动验证，少一步就静默失败。
