gulp入门2-src

gulp.src 是 Gulp 中用于指定要处理的文件或文件集合的重要函数。以下是关于 gulp.src 的详细教程，按照清晰的格式进行分点表示和归纳：

1. 基本概念

gulp.src 是 Gulp 的一个核心方法，它用于产生数据流，表示要处理的文件。你可以使用 glob 模式来匹配和选择文件，然后对这些文件执行一系列的操作（如压缩、合并、重命名等）。

2. 使用方法

2.1 引入依赖

首先，确保你已经安装了 Gulp 并引入了相关依赖：

const gulp = require('gulp');

2.2 使用 gulp.src

使用 gulp.src 来指定要处理的文件或文件集合：

gulp.src(globs[, options])

• globs：字符串或字符串数组，表示要处理的文件或文件集合的 glob 模式。
• options（可选）：一个对象，用于配置 gulp.src 的行为。

3. glob 模式示例

以下是一些 gulp.src 中使用 glob 模式的示例：

• 'js/app.js'：指定确切的文件名。
• 'js/*.js'：匹配 js 目录下所有 .js 格式的文件。
• 'js/**/*.js'：匹配 js 目录及其所有子目录中的所有 .js 文件。
• '!js/app.js'：排除 js/app.js 文件。
• '*.+(js|css)'：匹配项目根目录下所有后缀名为 js 或 css 的文件。

4. options 配置

gulp.src 的 options 参数可以是一个对象，用于配置其行为。以下是一些常用的选项：

• buffer：默认为 true。当为 true 时，文件内容将被缓冲到内存中。如果为 false，则文件的 contents 属性将是一个流。
• read：默认为 true。如果为 false，则文件将不会被读取，并且它们的 Vinyl 对象将不能通过 .dest() 写入磁盘。
• since：日期时间戳或函数。如果设置，则仅为自指定时间以来修改过的文件创建 Vinyl 对象。
• base：定义任务开始时的一个基本目录，从这个目录开始寻找 globs。
• cwd：当前工作目录。默认是 process.cwd()。
• allowEmpty：如果 globs 参数只能匹配一个文件但没有找到匹配时，设置为 true 可以抑制错误。

5. 示例

以下是一个简单的示例，演示如何使用 gulp.src 来匹配和处理文件：

const gulp = require('gulp');

gulp.task('scripts', function() {
  return gulp.src('js/**/*.js') // 匹配 js 目录及其所有子目录中的所有 .js 文件
    .pipe(somePlugin()) // 对匹配的文件执行某些操作（如压缩、合并等）
    .pipe(gulp.dest('dist/js')); // 将处理后的文件输出到 dist/js 目录
});

在这个示例中，我们首先使用 gulp.src 来匹配 js 目录及其所有子目录中的所有 .js 文件，然后使用 somePlugin() 对这些文件执行一些操作（这里只是一个占位符，你可以替换为你实际使用的插件），最后使用 gulp.dest 将处理后的文件输出到 dist/js 目录。