Gulp插件仅调用项目本地gulp，不认全局安装；需在项目根目录安装gulp和gulp-cli，确保node_modules/.bin/gulp存在，且Sublime打开的文件属于该项目上下文。
gulp 插件在 Sublime Text 里不是“装上就能跑”，它只调用你项目里已安装的本地 gulp 可执行文件，不认全局安装、不走 npx、不读 package.json scripts。错一个环节，就卡在 command not found 或 No tasks found。
确认项目中存在可执行的 gulp
Sublime 的 Gulp 插件（wbond 维护版）只找 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，否则软链可能失效 - 用
yarn v3+？默认启用 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']这类带冒号或空格的命名，插件无法调用（不支持引号语法）
任务运行失败但面板没输出
插件默认捕获 stdout/stderr 并显示在输出面板，但如果 task 内部抛出未处理的 Promise 拒绝、或调用 process.exit(1)，面板可能只显示 Task failed 而无细节。
- 先确认该 task 在终端能跑通：
npx gulp build（或./node_modules/.bin/gulp build） - 打开输出面板：
Ctrl+Shift+P→Tools: Toggle Build Results，确保它可见 - 检查
Preferences > Package Settings > Gulp > Settings中"show_output_panel": true是否启用 - Windows 用户若命令行能跑但 Sublime 不能，可能是 PATH 未被 shell 正确继承，需在设置里显式填
"gulp_path"，例如"C:/Program Files/nodejs/gulp.cmd"
gulpfile.js 和 node_modules/.bin/gulp 都存在，只要 Sublime 打开的文件不属于那个项目上下文，插件就当它不存在。 
