Gulp构建时出现gulp.src()链式调用报错pipe is not a function的问题
报错触发原因
该TypeError由两个代码逻辑问题直接导致:
- 原生
browserify返回的实例不是gulp生态通用的Vinyl流对象,无法直接通过.pipe()串联到gulp管线中。经过browserify处理后的返回对象不具备可链式调用的.pipe方法,因此后续调用.pipe(gulp.dest(...))时直接抛出类型错误。 - 你将browserify的管线代码直接写在gulpfile的顶层作用域,未封装到具体的gulp任务函数内,文件加载阶段就会执行这段无效的流串联逻辑,完全脱离gulp的任务执行流。
解决步骤
1. 补充缺失的适配依赖
已安装的gulp/browserify/reactify无法完成流格式兼容,需要额外安装vinyl-source-stream,用于将browserify打包输出的内容转换为gulp可识别的Vinyl流对象,执行安装命令:npm install vinyl-source-stream --save-dev
2. 代码调整说明
- 将browserify的全部构建逻辑移入
react任务函数内部,由任务调度触发执行,而非文件加载时自动运行 - 调用browserify实例的
.bundle()方法正式启动打包流程,再通过vinyl-source-stream转换输出流格式,接入gulp的管线逻辑 - 修正watch监听的路径错误:原配置中jsx匹配路径前多了一个空格,会导致文件变动无法被正常监听
- 移除顶层无意义的导出语句
module.exports = gulp;
修正后的完整可运行代码
var gulp = require('gulp'); var browserify = require('browserify'); var reactify = require('reactify'); var source = require('vinyl-source-stream'); gulp.task('react', function(){ return browserify({ entries: 'src/App.js', insertGlobals: false, debug: true, transform: [reactify] }) .bundle() .pipe(source('App.js')) .pipe(gulp.dest('./dist/js')); }); gulp.task("watch", function(){ gulp.watch(["src/**/*.js", "src/**/*.jsx"], ["react"]); }) // 默认任务先执行一次打包,再启动文件监听 gulp.task("default", ["react", "watch"]);
注意:当前
reactify已停止维护,如果后续遇到JSX语法编译兼容问题,可以替换为官方维护的babelify配置,核心的流适配逻辑不需要改动。
内容的提问来源于stack exchange,提问作者SupEldrix
相关产品推荐
相关产品推荐

