Sublime Gulp 插件安装失败主因是 Package Control 未安装或失效，需手动安装并重启；菜单灰显因缺少 gulpfile.js 或 gulp 命令不可达；任务不刷新需删缓存并刷新；无输出需开启输出面板并检查权限与项目打开方式。
Sublime Gulp 插件装不上？先确认 Package Control 是活的
插件装不上，90% 的情况不是 Sublime Gulp 本身的问题，而是 Package Control 没就位或失效了。它不是预装组件，必须手动激活。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Install Package—— 如果根本搜不到，说明 Package Control 没装好 - 这时得手动安装：打开 Sublime 控制台（
Ctrl+`），粘贴官方安装脚本（注意 Python 版本适配，Sublime Text 4 默认用 Python 3）：import urllib.request,os,sys; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 装完重启 Sublime，再试
Package Control: Install Package，搜Sublime Gulp就能列出来
装上了却点不动 Gulp 菜单？检查 gulpfile.js 和 gulp 命令路径
菜单灰掉、Tools > Gulp 不出现，说明插件没识别到有效 Gulp 环境 —— 它只在“有 gulpfile.js 且能调起 gulp 命令”的目录下才激活。
- 确保项目根目录下存在
gulpfile.js（或gulpfile.coffee），文件不能空，至少导出一个任务，比如：const gulp = require('gulp'); gulp.task('default', () => {}); - 运行
gulp --version确认命令行能执行；如果报command not found，说明gulp-cli没全局装，或 PATH 没生效 - 插件默认走系统 PATH 找
gulp，但 Windows 上常见路径是C:/Program Files/nodejs/gulp.cmd，需在Preferences > Package Settings > Sublime Gulp > Settings里显式填入"gulp_path"
Gulp 任务列表为空或不刷新？缓存和文件监控要手动干预
第一次打开项目时任务没列出来，或者改了 gulpfile.js 后列表还是旧的，大概率是缓存没重建或 watch 没触发。
- 插件靠生成
.sublime-gulp.cache文件加速任务解析，但改了任务名或结构后不会自动更新 —— 必须手动删掉这个缓存文件，再按Ctrl+Shift+P→Gulp: Refresh Tasks -
gulp.watch()在 Sublime 内部不自动启用；插件只负责“运行一次”，不接管后台监听。想实时响应保存，得在gulpfile.js里写好watch任务（比如叫dev），然后手动运行它 - Windows 下频繁保存可能触发
EBUSY: resource busy or locked错误，这不是插件问题，是 Node.js 文件句柄未释放 —— 可临时加await new Promise(r => setTimeout(r, 100))缓冲，或换用chokidar替代原生fs.watch
为什么运行任务没输出、或一闪而过？面板和配置要对上
点了 Run Default Task 却看不到任何日志，甚至不知道任务是否真执行了，通常是输出面板被关了或路径权限不对。
- 检查设置里
"show_output_panel": true是否开启；关闭状态下任务静默运行，失败也不提示 - 如果输出面板弹出但内容为空，可能是 gulp 进程被杀掉或卡住 —— 插件提供
Gulp: Kill Running Task命令，务必先执行它再重试 - macOS 或 Linux 上若提示
Permission denied，别直接 chmod 全局 gulp，而是把"gulp_path"改成项目级路径："./node_modules/.bin/gulp"，前提是本地已装gulp-cli
最常被跳过的其实是“项目目录是否真正打开”——Sublime Gulp 不作用于单个文件，只认 Project > Open Folder 打开的整个文件夹。用 File > Open 打开单个 gulpfile.js，菜单压根不会出现。
