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）也写了构建脚本，它不会自动发现。

抖音下载器(Node.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、那个语法解析器 —— 所有看似随机的失败，基本都能回溯到这三个路径是否对齐。