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，**不会扫描整个工作区，也不识别多根工作区中的子项目根**。
前端设计与 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——这两步必须手动验证，不能凭“我装过了”就跳过。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
