在Gulp流管道中添加复制文件后未输出，请求排查原因

我有一个Gulp流，读取数百个markdown文件并通过一系列管道处理，代码如下：

var mystream = src('app/pages/**/*.md')
    .pipe(frontMatter({
        property: 'fm',
        remove: true
    }))

    .pipe(data(function (file) {
        if (file.fm.title) file.fm.title_html = markdown.marked.parseInline(file.fm.title)
        if (file.fm.description) file.fm.description_html = markdown.marked(file.fm.description)
    }))

    .pipe(data(process_last_update))

// ...还有10个左右的管道，最后写入流....

    .pipe(dest('site'))

这部分功能正常。我想要在其中一个管道阶段，检查markdown文件的frontmatter，若存在特定值（字符串数组slug_history），则复制文件并设置为frontmatter中指定的路径，再将其添加到流中。

我尝试的代码如下：

.pipe(data(function (file) {
        if (file.fm.slug_history) {
            file.fm.slug_history.forEach(slug => {
                let newfile = Object.assign({}, file);
                newfile.path = file.base + "/" + slug + "/index.html";
                mystream.write(newfile);
            })
        }
    }))

但末尾的.pipe(dest('site'))并未写入我添加到流中的额外文件，请问我哪里操作错误？

你的问题出在三个关键地方：

1. 直接调用mystream.write()不符合Gulp流逻辑：Gulp基于Node.js转换流实现，不能直接往顶层流对象写数据。正确做法是在转换流内部通过this.push()添加新文件，而非操作原始流。

2. 浅拷贝Vinyl文件对象失效：Object.assign({}, file)是浅拷贝，无法复制Vinyl文件的内部属性与方法，会导致新文件无法被Gulp正确识别处理。必须用file.clone()方法克隆文件。

3. 路径设置方式错误：直接修改newfile.path会破坏Gulp的路径解析逻辑，应该用path.join()构建跨平台兼容的正确路径。

正确实现代码 #

const through = require('through2');
const path = require('path');

// ...其他代码...

var mystream = src('app/pages/**/*.md')
    .pipe(frontMatter({
        property: 'fm',
        remove: true
    }))

    .pipe(data(function (file) {
        if (file.fm.title) file.fm.title_html = markdown.marked.parseInline(file.fm.title)
        if (file.fm.description) file.fm.description_html = markdown.marked(file.fm.description)
    }))

    .pipe(data(process_last_update))

    // 替换原data管道，用through2处理文件克隆与添加
    .pipe(through.obj(function(file, enc, cb) {
        // 先推送原始文件，保证原有流程不受影响
        this.push(file);

        // 处理slug_history生成历史路径文件
        if (file.fm.slug_history) {
            file.fm.slug_history.forEach(slug => {
                // 深度克隆Vinyl文件，保留所有属性
                const newFile = file.clone({deep: true});
                // 构建正确的目标路径
                newFile.path = path.join(file.base, slug, 'index.html');
                // 将新文件推入流中
                this.push(newFile);
            });
        }

        cb();
    }))

    // ...其他管道...

    .pipe(dest('site'));

核心要点 #

• 使用through2.obj()创建对象模式的转换流，这是Gulp处理文件的标准方式。
• 先推送原始文件，再推送克隆的历史路径文件，确保原始文件的正常处理流程。
• 用file.clone({deep: true})深度克隆Vinyl文件，避免丢失关键属性。
• 用path.join()构建路径，适配不同操作系统的路径分隔符。

修改后，dest('site')就能正确写入原始文件和所有克隆的历史路径文件了。

内容的提问来源于stack exchange，提问作者Chad