Sublime Text的Gulp插件仅调用项目本地gulp（node_modules/.bin/gulp），不支持全局安装、不递归查找gulpfile.js，且任务名区分大小写、不可含空格；需手动验证gulp路径与gulpfile位置，否则报“command not found”或“No tasks found”。

gulp 任务在 Sublime Text 中不是“配一下就能用”，它依赖本地项目环境、插件行为边界和路径解析规则——**插件只调用你项目里已安装的 gulp，不帮你装、不认全局、不递归找 gulpfile.js**。错一个环节，就卡在 “gulp command not found” 或 “No tasks found”。

确认项目级 gulp 已就位，且可被插件定位

Sublime 的 Gulp 插件（wbond 维护版）只检查 node_modules/.bin/gulp（Linux/macOS）或 node_modules\.bin\gulp.cmd（Windows），完全忽略全局安装的 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，否则 .bin 下的链接可能失效
• 若用 yarn，确保未启用 nodeLinker: "pnp"（PnP 模式下 .bin 不生成）

安装并验证 Gulp 插件是否真正加载

插件名就是 Gulp，不是 SublimeGulp 或 SublimeLinter-gulp；它仅兼容 Sublime Text 4+，旧版会报 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'，说明插件未适配当前 ST 版本，可临时换用 SublimeLinter-gulp（仅提供任务列表，不运行）

让插件找到 gulpfile.js：路径推断规则很窄

插件默认只从当前打开的文件所在目录开始，向上逐级搜索 gulpfile.js，**不会扫描整个工作区，也不识别多根工作区中的子项目根**。

前端设计优化skill

前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。

下载

• 确保至少有一个文件属于你的项目目录（比如打开了 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，但对未处理的 Promise reject、process.exit(1) 或异步异常响应迟钝，面板常只显示 “Task failed”。

立即学习“前端免费学习笔记（深入）”；

• 先在终端中手动运行：npx gulp build（或 ./node_modules/.bin/gulp build），确认任务本身能跑通
• 在 gulpfile.js 中给关键 task 加 on('error', console.error)，避免异常静默吞掉
• 若用 gulp.watch()，注意 Sublime 插件不接管 watch 生命周期——它只启动一次，后续文件变化靠 Gulp 自己监听，插件面板不会刷新
• 任务名区分大小写，且不能含空格；gulp.task('Build') 和 gulp.task('build') 是两个任务，插件只会列出后者（小写开头更稳妥）

真正卡住的地方，往往不是语法写错，而是插件根本没拿到 gulp 可执行文件，或者压根没找到 gulpfile.js——这两步必须手动验证，不能凭“我装过了”就跳过。