gulp-if vs gulp-ignore：Gulp排除文件方案终极对决

【免费下载链接】gulp-if Conditionally run a task 项目地址: https://gitcode.com/gh_mirrors/gu/gulp-if

在 Gulp 自动化构建中，Gulp排除文件是最常见的需求之一：哪些文件需要压缩、哪些需要跳过、哪些压根不该进入任务流。围绕这个问题，社区诞生了两大经典方案——gulp-if 和 gulp-ignore。它们都能"条件化执行 Gulp 任务"，但思路截然不同。本文用最通俗的方式，帮你一次性搞懂 gulp-if 和 gulp-ignore 的区别，并给出不同场景下的最佳 Gulp 排除文件方案。

什么是 gulp-if？Gulp 文件流条件判断神器

gulp-if 是一个"三元表达式"式的 Gulp 插件，项目描述就一句话：Conditionally run a task（条件化执行任务）。它像 JavaScript 里的三元运算符一样工作：给每个流经的文件做一次条件判断，为真走一条管道，为假走另一条管道，或者直接放行。

它最强大的地方在于，判断条件非常灵活：

• ✅ 布尔值：整个任务统一开关
• ✅ 函数：逐个文件判断，比如按文件路径过滤
• ✅ 正则表达式 / glob 规则：匹配 file.path

核心 API 只有一行：gulpif(condition, stream [, elseStream])，完整实现可参考项目的 index.js。

gulp-if vs gulp-ignore：一张表看懂核心区别

两者的名字容易混淆，但定位完全不同，这里直接给出最核心的对比：

对比维度	gulp-if	gulp-ignore
定位	条件分流（if/else）	从流中排除文件
条件为真时	文件进入指定处理流	文件被丢弃，不再向下游传递
条件为假时	走 else 分支或直接放行	正常放行
是否改变文件流向	是，可切换处理管道	否，只有"丢"或"留"
典型场景	按需压缩、按分支处理	剔除 gulpfile、配置文件

简单说：gulp-if 是"路由"，把文件送向不同处理管道；gulp-ignore 是"安检"，决定哪些文件直接出局。理解了这一点，gulp 排除文件方案的选择思路就清晰了一大半。

gulp-if 条件过滤的快速上手用法

面向新手，我们看一个最经典的场景：只有生产环境才压缩 JS，开发环境直接放行。

var gulpif = require('gulp-if');
var uglify = require('gulp-uglify');
var isProd = process.env.NODE_ENV === 'production';

gulp.task('scripts', function() {
  return gulp.src('./src/*.js')
    .pipe(gulpif(isProd, uglify()))
    .pipe(gulp.dest('./dist/'));
});

条件为真时走 uglify()，为假时原样放行，所有文件最终都会进入 dist 目录。这只是入门，gulp-if 三元分支还能实现更复杂的场景——比如生产环境压缩、开发环境美化：

.pipe(gulpif(isProd, uglify(), beautify()))

gulp-ignore 排除文件的经典用法

如果你要的是"某些文件彻底不参与后续处理"，gulp-ignore 更直接。经典场景：JSHint 检查所有 JS，但把 gulpfile.js 排除掉，不参与后续压缩：

var gulpIgnore = require('gulp-ignore');

gulp.task('task', function() {
  return gulp.src('./*.js')
    .pipe(jshint())
    .pipe(gulpIgnore.exclude('./gulpfile.js'))
    .pipe(uglify())
    .pipe(gulp.dest('./dist/'));
});

文件进入流之后才被剔除，适合"先统一检查、再选择性放行"的场景。需要注意：gulp-ignore 的包名是 gulp-ignore，与 gulp-if 是独立项目，切勿混淆。

用 gulp.src 的 glob 模式排除文件：最快方案

其实还有第三种更快的思路——在源头就过滤掉。用 gulp.src 的 ! 否定模式，让文件根本不进入流：

gulp.src(['./*.js', '!./node_modules/**'])

例如 Gulp 排除 node_modules 时，这个方案性能最佳：因为 node_modules 里的文件压根不会离开 gulp.src()，不会产生任何多余开销。如果你追求极致的构建速度，优先考虑这种源头排除法。

如何选择？按场景选对 Gulp 排除文件方案

你的需求	推荐方案
按环境开关某个任务	gulp-if（布尔条件）
按文件名/路径分流处理	gulp-if（函数或正则条件）
处理一半时剔除特定文件	gulp-ignore.exclude
排除整个目录，追求性能	gulp.src 的 ! 否定模式
条件内嵌多条处理管道	gulp-if + lazypipe

进阶：gulp-if 配合 lazypipe 构建复杂流水线

gulp-if 官方特别推荐与 lazypipe 搭配：当"条件为真"时需要执行多条处理步骤时，用 lazypipe 把管道链封装成一个函数，再传给 gulp-if，就能在条件内部构建多步骤流水线（详见项目 README.md 和测试文件 test/boolean.js 中的用法示例）。

终极结论

Gulp 排除文件没有银弹，但有了这份对比，选型变得很简单：要"分流"用 gulp-if，要"剔除"用 gulp-ignore，要"性能"用 glob 源头排除。三种方案各司其职、组合使用，就能写出又快又清晰的 Gulp 构建脚本。如果你还在为构建管道里的条件逻辑头疼，不妨从 gulp-if 开始尝试，它会让你的 Gulp 任务流变得前所未有的灵活。

【免费下载链接】gulp-if Conditionally run a task 项目地址: https://gitcode.com/gh_mirrors/gu/gulp-if