Sublime Text 的 Gulp 插件仅调用项目本地 node_modules/.bin/gulp，不支持全局安装、不递归查找 gulpfile.js、不兼容 ST3；必须在项目根目录安装 gulp 和 gulp-cli，确保插件加载成功（状态栏显示 Gulp）且当前文件属于项目上下文，否则报“command not found”或“No tasks found”。
Sublime Text 里 Gulp 插件不会自动“配好就跑”，它只调用你项目里已安装的 node_modules/.bin/gulp，不认全局安装、不递归找 gulpfile.js、也不兼容旧版 ST3。漏掉任一环节，就会卡在 command not found 或 No tasks found。
确认项目本地 gulp 已安装且路径可访问
插件只检查 node_modules/.bin/gulp（macOS/Linux）或 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
安装并验证 wbond 维护的 Gulp 插件是否加载成功
插件名就是 Gulp，不是 SublimeGulp 或 SublimeLinter-gulp；仅兼容 Sublime Text 4（API v4+），ST3 用户会看到 ImportError: No module named 'sublime'。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车后搜Gulp安装 - 重启 Sublime，右下角状态栏必须出现
Gulp字样——这是唯一可靠加载信号 - 若无反应，按
Ctrl+`打开控制台，搜no module named 'sublime'；出现即说明版本不匹配，可临时换用SublimeLinter-gulp（仅列任务，不运行）
让插件定位到你的 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']这类含冒号或空格的命名，插件无法调用（不支持引号语法）
运行任务时面板无输出或报错不明确
插件默认捕获 stdout/stderr 并显示在输出面板，但如果 task 内部抛出未处理的 Promise 拒绝、或调用 process.exit(1)，面板可能只显示 Task failed 而无细节。
- 先在终端手动运行
npx gulp --tasks，确认任务列表正常、无语法错误 - 避免在 task 中直接写
process.exit(1)；改用throw new Error(...)或return Promise.reject(...) - 若用
async/await，确保函数返回 Promise，且所有异常被try/catch捕获并显式console.error - 输出面板关闭后，再次运行任务不会自动弹出；需手动打开
View → Show Console或按Ctrl+`查看原始日志
最常被忽略的是路径推断逻辑和插件加载信号——不是“装了插件就能用”，而是“插件只在特定上下文里认得你”。一旦 Gulp 没出现在状态栏右下角，后面所有配置都无效。
