Sublime Text 需通过 wbond 维护的 Gulp 插件调用本地 gulp，必须在项目中安装 gulp 和 gulp-cli 至 node_modules/.bin/，插件不支持全局 gulp、package.json scripts 或 npx，且仅在当前文件目录及父级搜索 gulpfile.js。
Sublime Text 本身不内置 Gulp 支持，必须通过插件 Gulp（由 wbond 维护）接入本地项目中的 gulpfile.js。它只负责调用你项目里已安装的本地 gulp，不是替代 CLI 或重写构建逻辑。
确认本地 gulp 已正确安装在项目中
Sublime 的 Gulp 插件不会帮你装 gulp，它只找 node_modules/.bin/gulp。如果你只全局装了 gulp（npm install -g gulp-cli），插件大概率报错 gulp command not found。
- 必须在项目根目录执行
npm install --save-dev gulp gulp-cli - 检查是否存在
node_modules/.bin/gulp（Linux/macOS）或node_modules\.bin\gulp.cmd（Windows） - 如果用了 pnpm 或 yarn，确保
.bin目录被 shell 正确识别；pnpm 用户可加"preferSymlink": true到.pnpmrc避免路径解析失败
安装并配置 Sublime 的 Gulp 插件
插件名就是 Gulp，不是 SublimeGulp 或其他变体。它依赖 Package Control，且不兼容 Sublime Text 4 之前的旧版 API。
- 打开 Command Palette（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package，回车后搜Gulp并安装 - 安装后重启 Sublime，确保状态栏右下角出现
Gulp字样（表示插件已加载） - 若无反应，检查 Console（
Ctrl+`）是否有ImportError或no module named 'sublime'—— 这说明插件未适配当前 ST 版本，需手动更新或换用SublimeLinter-gulp作轻量替代
运行任务时找不到 gulpfile.js 或报错 “No tasks found”
插件默认只在当前打开的文件所在目录及其父级中搜索 gulpfile.js，不会递归扫描整个工作区。常见于多根工作区或子模块项目。
- 确保当前视图中至少有一个文件属于你的项目目录（比如打开了
src/index.js），否则插件无法推断工作路径 - 手动指定路径：按
Ctrl+Shift+P→ 输入Gulp: Set Gulp File Path→ 填入绝对路径，如/Users/you/project/gulpfile.js - 任务名区分大小写，且不能含空格或特殊字符；
exports.default会被识别为default，但exports['build:css']必须用引号调用，插件不支持这种命名方式
调试 task 报错但控制台没输出
Sublime 的 Gulp 插件默认捕获 stdout/stderr 并显示在面板里，但如果 task 内部抛出未处理的 Promise 拒绝或 process.exit(1)，面板可能只显示“Task failed”而无细节。
- 在
gulpfile.js顶部加process.on('unhandledRejection', console.dir)捕获异步错误 - 避免在 task 中直接
console.log，改用require('gulp-util').log()或console.error()确保输出进面板 - 临时把 task 改成同步形式测试：例如
exports.test = () => { console.log('ok'); }，排除流/异步链中断问题
最常被忽略的是：Sublime 的 Gulp 插件完全不读取 package.json 的 scripts 字段，也不支持 npx gulp 自动 fallback —— 它只认 node_modules/.bin/gulp 和显式导出的函数。路径、权限、Node 版本差异（尤其 Apple Silicon 上 Rosetta 兼容性）都可能让“明明命令行能跑”的 task 在 Sublime 里静默失败。
