WebStorm 默认不识别 ES6 写法的 gulpfile.js，需在 Gulp.js 运行配置的 Node 选项中添加 --harmony 参数，并确保 Gulp package 指向本地 node_modules/gulp，否则任务树为空或报错。
WebStorm 能直接运行 Gulp 任务，但默认不识别 ES6 写法的 gulpfile.js，会导致任务树为空或报错 Cannot find module 'gulp' 或 Unexpected token import —— 这不是插件没装好，而是 Node 启动参数没配对。
WebStorm 找不到 Gulp 任务？先检查 --harmony 参数
WebStorm 默认用旧版 V8 引擎解析 gulpfile.js，遇到 import、const、箭头函数就会失败，连任务列表都刷不出来。
- 打开
Run | Edit Configurations…→ 左侧模板下点Gulp.js - 在
Node options栏里填入--harmony（注意是两个短横） - 确保
Gulp package指向项目本地的node_modules/gulp，不是全局安装路径 - 改完后点
Reload tasks按钮（Gulp 工具窗口右上角那个循环图标）
多个 gulpfile.js 共存时，任务总跑错文件
WebStorm 默认只加载项目根目录下的 gulpfile.js，如果你在子目录（比如 client/gulpfile.js、admin/gulpfile.js）也写了构建脚本，它不会自动发现。
- 在 Gulp 工具窗口顶部点击
Add Gulpfile（+ 号按钮） - 手动选中子目录里的
gulpfile.js，它会新增一个独立节点，带完整路径名 - 每个节点下的任务树彼此隔离，双击运行时不会跨文件混用
- 删错节点别慌：右键该节点 →
Remove Gulpfile即可
传参给 Gulp 任务时，--env production 不生效
WebStorm 的 Parameters 字段只负责把参数透传给 Gulp CLI，但最终能否被任务读取，取决于你在 gulpfile.js 里怎么解析 —— 它不自动挂到 process.argv 或 gulp.env 上。
- 在运行配置的
Parameters栏输入：--env development --port 8080 - 在
gulpfile.js中用require('yargs').argv或minimist(process.argv.slice(2))显式解析 - 别依赖
gulp.env：这是老版本gulp-util提供的，已废弃且 WebStorm 不兼容 - 如果参数含空格（如
--name "my project"），WebStorm 会截断，建议改用下划线命名
任务执行卡住或输出乱码？重点看 Node.js 运行时设置
WebStorm 有时会误用系统全局 Node，而不是项目里 .nvmrc 或 package.json 指定的版本，尤其当你用 nvm / fnm 切换 Node 版本时。
- 进运行配置 →
Node.js runtime下拉菜单，选Project default（不是System default） - 确认项目根目录有
.nvmrc或engines.node字段，否则 WebStorm 可能选错版本 - Windows 用户若看到中文乱码，关掉
Settings | Editor | File Encodings里的Transparent native-to-ascii conversion - 终端里能跑通但 WebStorm 报错？大概率是环境变量差异，勾选
Include system environment variables
真正麻烦的从来不是“怎么点出来”，而是 WebStorm 在后台静默调用 Node 时，用的到底是不是你认为的那个 Node、那个 Gulp、那个语法解析器 —— 所有看似随机的失败，基本都能回溯到这三个路径是否对齐。
