返回：唐霜｜书

gulp中文入门教程

简明的gulp中文入门教程，从实战角度出发，同时囊括相关的知识点，让开发者真正做到入门。

前言

【本文受版权保护】【原创内容，转载请注明出处】【作者：唐霜】【转载请注明来源】

前端开发已经不再只是搞搞样式，处理处理交著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】互那么简单，前后端分离，后端只为前端提供【作者：唐霜】本文作者：唐霜，转载请注明出处。api数据接口，以前url路由、html本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】结构都需要后端来架构，如今这些全靠前端来【版权所有，侵权必究】【原创内容，转载请注明出处】处理，前端也具备了工程性。

这几年，模块化开发已经成为web应用前端本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】开发的共识。以往套上jQuery走天下的【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net时代已经过去了，前端已经发展成为复杂的大转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net型应用开发工作。以SPA（Single 【原创不易，请尊重版权】【作者：唐霜】Page Application）为代表原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。的单页应用成为现在很多大公司发布前端产品【本文受版权保护】【原创不易，请尊重版权】的形式，以往以html+css+js的前【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。端在这里已经不适用了，将所有资源进行打包本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。，正是解决这种需求的方案，webpack【未经授权禁止转载】【版权所有，侵权必究】等打包工具也孕育而生。

【本文受版权保护】【作者：唐霜】【作者：唐霜】【原创内容，转载请注明出处】

一年多以前，我接触的前端和上面的“以往的【转载请注明来源】【关注微信公众号：wwwtangshuangnet】前端”并无二致，直到我进入morning本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。star，才逐渐认识到自己在前端领域是多【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net么肤浅。我在自己的博客中，多次把自己工作转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。中认知的，morningstar的开发p【版权所有，侵权必究】【本文首发于唐霜的博客】attern进行分享。同时，我现在所在的本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】项目也正是使用gulp+webpack进本文版权归作者所有，未经授权不得转载。【本文受版权保护】行开发的，因此，我希望通过撰写（翻译）这转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。本手册，既让自己重新回顾一下gulp的使【作者：唐霜】本文版权归作者所有，未经授权不得转载。用，以及希望在这个过程中有新的收获。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】

同时，我打算自己写中文手册，也是因为苦于【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net没有比较好的中文手册给刚入门的同学使用，【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】所以希望趁工作回家后的时间，快速的写出一【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net本针对中国开发者快速入门和理解的文档。

你可以在gitbook上在线阅读，也可以在github上fork所有源文件，对文档的细节进行补本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】充。

【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】

gulp官方文档

【作者：唐霜】

【访问 www.tangshuang.net 获取更多精彩内容】

【作者：唐霜】

转载请注明出处：www.tangshuang.net

gulp中文文档（翻译）

【作者：唐霜】

我以前都是以文章的形式分享技术内容，我觉未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。得技术的东西，用文章那种分散性的形式发表【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。，会让人知识体系比较混乱，仅仅适合解决一【原创不易，请尊重版权】【原创内容，转载请注明出处】些具体的细节性技术问题，而采用book的转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。形式分享，则更有利于形成完整的知识体系。【本文受版权保护】【作者：唐霜】这是我第一次写一份完整的文档，并且阅读了原创内容，盗版必究。【版权所有，侵权必究】不少英文材料，但是感觉还是不够详细，如果【本文受版权保护】原创内容，盗版必究。你有什么意见或觉得不足的地方，可以通过g本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ithub、博客等各个渠道向我反馈。

快速入门

这一节你不需要知道背后的原理，只需要按照【作者：唐霜】【本文首发于唐霜的博客】文章中的提示一步一步进行操作。

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】

我的所有开发都是在ubuntu上面完成的原创内容，盗版必究。转载请注明出处：www.tangshuang.net，所以本文档中可能会涉及一些ubuntu【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。 linux下的一些命令，如果你不接触u著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。buntu，甚至不接触linux，都没有【版权所有，侵权必究】【本文受版权保护】任何关系，因为我们是要用gulp，而不是转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。在纠结命令，而且在后面的文档中，我会对大【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net部分命令进行解释。
原创内容，盗版必究。 gulp是node的一个模块（包），因【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net此大部分情况下，我们通过npm进行安装。【本文受版权保护】【转载请注明来源】当然，高手而言，甚至可以下载包，手动进行原创内容，盗版必究。【版权所有，侵权必究】安装。熟悉npm的朋友，也推荐了解一下y未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。arn，它也是个包管理工具，但是效率上比【原创内容，转载请注明出处】【原创内容，转载请注明出处】npm高效（快）。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。

现在，我假设你手上有一台拥有开发环境的u著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】buntu16.04LTS，但是还没有接【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net触node，我会手把手教你一步一步完成安【未经授权禁止转载】原创内容，盗版必究。装。

【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】

1) 安装node

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。

$ sudo apt install nodejs

假如你的ubuntu不支持apt，可以替【原创内容，转载请注明出处】【转载请注明来源】换为apt-get。

【未经授权禁止转载】未经授权，禁止复制转载。【原创内容，转载请注明出处】【未经授权禁止转载】

2) 安装和升级npm

转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

$ sudo apt install npm$ npm update -g npm

3) 安装gulp-cli

【未经授权禁止转载】未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net

【本文受版权保护】原创内容，盗版必究。【作者：唐霜】转载请注明出处：www.tangshuang.net

$ npm install -g gulp-cli

为什么不是安装gulp呢？暂且按住不表。

【作者：唐霜】转载请注明出处：www.tangshuang.net

4) 创建一个项目

原创内容，盗版必究。【作者：唐霜】原创内容，盗版必究。未经授权，禁止复制转载。

$ mkdir my_project$ cd my_project$ npm init

在出现的交互信息中，填写和你项目相关的信本文作者：唐霜，转载请注明出处。原创内容，盗版必究。息。

5) 把gulp作为这个项目的一个依赖

$ npm install --save-dev gulp

上面我们留了一个问题，说为什么上面安装的本文作者：唐霜，转载请注明出处。【转载请注明来源】是gulp-cli，而不是gulp。这里本文版权归作者所有，未经授权不得转载。【本文受版权保护】就有答案。

【关注微信公众号：wwwtangshuangnet】【转载请注明来源】著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。

我们npm install的gulp将会【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。被保存到my_project这个目录下的著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。node_mudules目录下去，pac未经授权，禁止复制转载。原创内容，盗版必究。kage.json文件的dependen【本文受版权保护】本文版权归作者所有，未经授权不得转载。cesDev字段也会被增加一个gulp的本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。记录。

【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】

这是因为npm install gulp【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。时安装的gulp是一个node模块，是一【作者：唐霜】本文作者：唐霜，转载请注明出处。个项目依赖的包，我们将会在自己的项目代码【版权所有，侵权必究】【版权所有，侵权必究】里面用var gulp = requir【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。e(‘gulp’【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】)的形式引用这个包，而这个包，才会是我们【未经授权禁止转载】未经授权，禁止复制转载。下面API一章中的所有api的主人。而gulp-c【版权所有】唐霜 www.tangshuang.net【转载请注明来源】li，在这里没有半点关系，cli真的只是转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】一个命令行工具，而不是我们用来requi原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.netre的东西。

原创内容，盗版必究。原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。

6) 创建一个gulpfile.js文件

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【原创不易，请尊重版权】【未经授权禁止转载】

var gulp = require('gulp');
gulp.task('my_task', function() {
  setInterval(function(){
    console.log('I am out!');
  },5000);
});

7) 执行gulp任务

【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。

$ gulp my_task

这个时候，你就会发现，在你的命令行里面每本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。隔5秒出现一下’I am o【本文首发于唐霜的博客】【转载请注明来源】ut!’这句话。使用Ctrl本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】+C退出来。

本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】【作者：唐霜】

通过上面这些步骤，你可以轻松快速的创建自【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】己的gulp工具，在你的项目里面使用gu【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。lp工具帮你自动化的完成一些任务。比如举【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。一个简单的例子，你可以在你的源代码里面写【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。ES6的代码，通过gulp的一系列处理，【未经授权禁止转载】【版权所有，侵权必究】自动生成一个编译成ES5的js文件。当然【作者：唐霜】著作权归作者所有，禁止商业用途转载。，大部分任务都需要使用插件，或额外编写n【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netode脚本来执行。这些，我们都将在这本手本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net册里一一提到。

原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。

安装

这一章将让你学会如何安装gulp环境，以本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。及如何在项目中加入gulp，从而可以使用未经授权，禁止复制转载。【原创不易，请尊重版权】gulp。

本文版权归作者所有，未经授权不得转载。【本文受版权保护】著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】

你可能从来没有接触过node，不要紧，我著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。会教会一个完全不懂node的人如何来搭建【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net。当然了，你必须得懂javascript【原创内容，转载请注明出处】【原创不易，请尊重版权】，而且最好你对前端领域比较热门的东西都有【版权所有，侵权必究】未经授权，禁止复制转载。所了解，这样才不至于在提到一些东西的时候【作者：唐霜】【原创不易，请尊重版权】不之所以。

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

让我们开始吧！

本文版权归作者所有，未经授权不得转载。【作者：唐霜】【原创不易，请尊重版权】

Node

这一节主要讲如何去配置一个node环境，【本文受版权保护】未经授权，禁止复制转载。除了安装node之外，我们还需要安装np转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】m。

【作者：唐霜】本文版权归作者所有，未经授权不得转载。

node安装

因为我的大部分开发都是在ubuntu下面未经授权，禁止复制转载。【本文受版权保护】进行的，所以这个文档默认会使用ubunt【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】u作为讲解。当然，也会提到windows原创内容，盗版必究。【原创不易，请尊重版权】下面的处理方法，但是因为我很少在wind【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。ows下面实践，所以windows里面的本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。坑就不去挖了。

1）采用apt安装

ubuntu可以使用apt快捷安装：

【未经授权禁止转载】原创内容，盗版必究。【未经授权禁止转载】

$ sudo apt install nodejs

2）编译安装

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】未经授权，禁止复制转载。

一般apt源中的node都不是最新的稳定【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】版，而现在官方提供的最新稳定版是6.9.转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net1，所以我们可以通过下载官网的最新版本，未经授权，禁止复制转载。【转载请注明来源】在本地进行编译安装。

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

$ wget https://nodejs.org/dist/v6.9.1/node-v6.9.1.tar.gz$ tar -zxvf node-v6.9.1.tar.gz$ cd node-v6.9.1$ ./configure$ make$ make install$ make test

原创内容，盗版必究。【未经授权禁止转载】

【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。

3） windows下面安装node

到node的官网去下载稳定版的node exe/msi安【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】装文件，下载下来之后，像安装普通软件一样【本文首发于唐霜的博客】原创内容，盗版必究。安装好。

安装npm

什么是npm？它是Node Packag本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。e Manager的缩写，及一个包管理工原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。具。最近facebook发布了yarn，【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。也是和npm一样的包管理工具，而且性能上【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】比npm更好，有兴趣的同学可以尝试一下。

【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

为什么要管理node的包？在node中，本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】javascript以模块的形式存在。虽本文版权归作者所有，未经授权不得转载。【本文受版权保护】然我们可以像node test.js这样【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。去执行某个脚本，但是它天生具备modul【版权所有，侵权必究】【本文受版权保护】e功能。在node中通过require引【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。入一个模块，在模块中使用module.e【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。xports导出模块的接口。而模块，通常【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】情况下就是一个js文件，但是有些模块功能本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。比较复杂，被切割到不同的js文件中，虽然本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。这些js文件都是模块，但是把这些为实现同【关注微信公众号：wwwtangshuangnet】【转载请注明来源】一个功能的js放在一个文件夹下面，用一个未经授权，禁止复制转载。【原创内容，转载请注明出处】js作为统一对外的接口，再在这个文件夹内【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。放一个package.json，这样的放本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net在一个文件夹下面的一组文件，被成为“包”本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。，也就是package，package.【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.netjson里面规定了包名，出口文件是哪一个【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。等信息。关于package，我们会在后面著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。的文档讲到。

在ubuntu里面，同样可以使用apt安【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】装和编译安装两种安装方式。

【原创不易，请尊重版权】【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。

$ sudo apt install npm

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

$ npm install -g npm

这是一种奇怪的升级办法，npm本身也是n【版权所有，侵权必究】未经授权，禁止复制转载。ode的一个模块，但是在我们通过apt安原创内容，盗版必究。转载请注明出处：www.tangshuang.net装npm之前，没法使用npm，但是安装了本文作者：唐霜，转载请注明出处。【作者：唐霜】npm之后，就可以用npm安装自身，甚至【未经授权禁止转载】【本文首发于唐霜的博客】可以在后面跟上@版本，这样可以随意在不同【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】版本的npm之间切换。

未经授权，禁止复制转载。【原创不易，请尊重版权】

注意：升级npm之后，应该先关掉你的te【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】rminal后重新打开，我不知道这是为什【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】么，但是实践上需要这样做，否则仍然还在使本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。用老版本的npm。

未经授权，禁止复制转载。【未经授权禁止转载】

windows版最新的node自带了np【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】m包管理工具，所以不需要另外在下载安装。【原创内容，转载请注明出处】【转载请注明来源】但升级到最新版本的方法可以一样。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

安装git

git不算是node环境的东西，但是是安【作者：唐霜】【本文受版权保护】装一些特定的npm包需要的必备武器。

$ sudo apt install git

安装python2.7 （可选）

$ sudo apt install python

安装bower （可不安装，扩展阅读）

什么是bower？bower也是包，但是【作者：唐霜】原创内容，盗版必究。它和npm不同，npm管理的是node的本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net模块包，而bower是独立的各种软件包，【原创内容，转载请注明出处】【本文首发于唐霜的博客】比如jquery、bootstrap，它著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。们也可以通过npm来安装，也可以通过bo【本文受版权保护】【版权所有】唐霜 www.tangshuang.netwer来安装。bower和npm之间有很本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。多人进行对比，其实没有必要，我感觉bow本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。er比较简单干净，不会将依赖打包到自己的原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。包里，而npm包会把自己依赖的包打包在自著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】己内部。

著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。

所以我在实践中，大部分浏览器端要用的包都【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】用bower进行安装。

【未经授权禁止转载】未经授权，禁止复制转载。【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】

你也可以不安装bower，等到要的时候再【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】安装。

$ npm install -g bower

注意，bower默认情况下不允许用roo【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.nett用户去执行。不过一般ubuntu默认都【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。不是root用户。但是比较坑的是，在ub【本文受版权保护】本文作者：唐霜，转载请注明出处。untu上面，有时候npm又得用root本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。去执行，这取决于文件的可写权限。所以你只【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net需要记住，npm需要sudo，bower未经授权，禁止复制转载。原创内容，盗版必究。不需要sudo就可以了。或许这也是我更喜本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net欢用bower的原因。

【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】【本文受版权保护】转载请注明出处：www.tangshuang.net

现在，你已经搭建好了node环境，你的n【转载请注明来源】本文作者：唐霜，转载请注明出处。ode环境里面还有npm和git，现在可著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。以随便写一个js文件，然后用node去执【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。行一下它试试。要退出node执行状态，原创内容，盗版必究。【本文受版权保护】Ctrl+C就可以了。
【版权所有，侵权必究】【转载请注明来源】【未经授权禁止转载】【作者：唐霜】

package.json

每一个node模块包都有一个packag原创内容，盗版必究。本文作者：唐霜，转载请注明出处。e.json，而我们在node环境下开发【未经授权禁止转载】【作者：唐霜】项目，整个项目对于node而已，也是一个本文作者：唐霜，转载请注明出处。【作者：唐霜】包，所以也需要在我们的项目根目录下放一个原创内容，盗版必究。未经授权，禁止复制转载。package.json文件。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

我们看一个package.json文件的原创内容，盗版必究。转载请注明出处：www.tangshuang.net内容，它总是会包含这么一些内容：

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

{
  "name": "steerjs",
  "version": "1.0.0",
  "description": "a tool package to build your component more quickly",
  "main": "server.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": {
    "type": "git",
    "url": "git+https://github.com/tangshuang/steerjs.git"
  },
  "keywords": [
    "javascript",
    "component"
  ],
  "author": "frustigor",
  "license": "ISC",
  "bugs": {
    "url": "https://github.com/tangshuang/steerjs/issues"
  },
  "homepage": "https://github.com/tangshuang/steerjs#readme",
  "devDependencies": {
    "babel-core": "^6.18.2",
    "babel-preset-latest": "^6.16.0",
    "babel-register": "^6.18.0",
    "gulp": "^3.9.1"
  }
}

name 包的名称version 包的版本
description 包描述
main 入口文件，当require这个包名的时候，这个文件会被require进去。
repository 仓库信息
keywords 描述信息
author 作者信息
license 授权信息
bugs 如果其他人发现了bugs，应该怎么办homepage 包的主页地址
scripts 基于npm的脚本，例如上面这个，可以在命令行里，在这个包里面运行npm run test，就会显示一行字
dependencies 包依赖
devDependencies 包的开发依赖

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

dependencies和devDepe【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。ndencies有什么区别？前者是上线以著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】后的产品也需要依赖，比如你发布了一个包，本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】别人在npm install你的包的时候【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】，dependencies里面的包也必须【关注微信公众号：wwwtangshuangnet】【本文受版权保护】被安装才可以。devDependenci本文作者：唐霜，转载请注明出处。【未经授权禁止转载】es里面的包则不需要在使用这个包的时候安原创内容，盗版必究。本文作者：唐霜，转载请注明出处。装。但是如果你是开发这个包的人，会把开发【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】的时候需要用到的模块放在devDepen原创内容，盗版必究。【转载请注明来源】dencies里面，这样你在开发的时候执【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net行npm install，所有的包都会安【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。装好。

【本文受版权保护】【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

这个可能一时好理解，我就举个例子：假如你【版权所有】唐霜 www.tangshuang.net【转载请注明来源】是开发一个jquery插件，你开发的时候【未经授权禁止转载】转载请注明出处：www.tangshuang.net肯定需要像gulp、scss之类的辅助工原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】具进行打包压缩，你把gulp和scss相【转载请注明来源】本文作者：唐霜，转载请注明出处。关的包放在devDependencies【本文受版权保护】【本文受版权保护】里，然后npm install，然后就可【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net以使用scss编译你写的scss文件。开著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。发完了，你打算发布这个插件，但是发现这个【转载请注明来源】【作者：唐霜】插件发布后，用户必须先安装jquery才【本文首发于唐霜的博客】【原创不易，请尊重版权】行，否则插件不能使用，所以你把jquer著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】y放在dependencies。用户拿到著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】你的包之后，不需要gulp、scss，只本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】需要jquery就可以运行你的包。

【原创不易，请尊重版权】【转载请注明来源】【作者：唐霜】

$ npm install --save-dev gulp-minify

执行完之后再打开看package.jso【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。n文件，发现在devDependenci【转载请注明来源】著作权归作者所有，禁止商业用途转载。es里面自动多了gulp-minify。【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。–save和–s【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。ave-dev的区别是，安装的时候，&#著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。8211;save会把安装的新包加入到d【作者：唐霜】【版权所有，侵权必究】ependencies，–s转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。ave-dev则会加入devDepend【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。encies。
本文版权归作者所有，未经授权不得转载。另外，如果你打算npm uninsta【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ll，也要记得带上–save未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。[-dev]参数。

现在你已经了解了package.json本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】，马上在你的项目目录下创建一个packa本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.netge.json吧。创建完之后直接运行np【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】m install会安装所有依赖的包，快【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】试试看！

gulp-cli

在快速入门一节已经讲了gulp和gulp本文作者：唐霜，转载请注明出处。【作者：唐霜】-cli的区别。在编程的世界里，大部分c【原创不易，请尊重版权】【版权所有，侵权必究】li都指代命令行的意思，gulp-cli本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】就是可以在命令行里面运行gulp命令，而【原创不易，请尊重版权】【原创内容，转载请注明出处】纯粹的gulp并没有这个功能，它只能被r【转载请注明来源】未经授权，禁止复制转载。equire，然后执行你规定的任务，但是本文作者：唐霜，转载请注明出处。【未经授权禁止转载】你可能根本看不到，只有gulp-cli才转载请注明出处：www.tangshuang.net【未经授权禁止转载】能帮助你在命令行操作gulp，并且还能看未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。到gulp的运行状况。

本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】原创内容，盗版必究。【未经授权禁止转载】

安装gulp-cli

很简单，直接用npm就可以安装：

$ npm install gulp-cli

安装好gulp-cli之后，只是代表你的【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net电脑拥有了命令行执行gulp任务的能力，【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。并不表示你可以马上运行gulp命令。要运【本文受版权保护】著作权归作者所有，禁止商业用途转载。行命令还得你在自己的项目目录中，安装了g【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。ulp模块，通过gulpfile.js创【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net建了gulp任务，才能在这个项目目录里运【版权所有，侵权必究】【作者：唐霜】行gulp命令，在其他目录里运行gulp【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net命令无效，会报错。

【本文受版权保护】转载请注明出处：www.tangshuang.net

至于gulp-cli具体的用法，在CLI转载请注明出处：www.tangshuang.net【作者：唐霜】一章详细讲。

CLI命令行

什么是CLI？它是command-lin【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】e interface的缩写，中文翻译为本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。“命令行界面”，我们一般就直接用命令行代转载请注明出处：www.tangshuang.net【作者：唐霜】替了。DOS就是典型的命令行操作系统，早【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net期的unix和linux也是，后来lin【原创内容，转载请注明出处】【本文受版权保护】ux用上了开源的桌面引擎，也具备了桌面系转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net统，不过仍然保留着CLI，特别是作为远程本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】服务器，通过CLI对服务器进行操作可以节【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net省网络宽带，可以快速完成一些任务。

安装gulp-cli

Gulp CLI就是说可以在命令行里面运【本文首发于唐霜的博客】【本文受版权保护】行gulp相关的命令。这就依赖于gulp【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】-cli，因此，我们必须先安装gulp-本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。cli。
【未经授权禁止转载】如果我们不会在命令行下使用gulp，也原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。可以不用安装gulp-cli。但是如果我著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】们大部分情况下，还是在开发的时候通过gu【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。lp自动完成

转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

我们想要的一些任务，所以我们大部分情况下【原创内容，转载请注明出处】【本文首发于唐霜的博客】都会在命令行中执行gulp任务。

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】

$ npm install -g gulp-cli

gulp-cli使用

gulp cli使用非常简单，在命令行里本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】可以这样输入：

【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】未经授权，禁止复制转载。

$ gulp # 如果后面没有跟任务名称，就直接默认使用default这个任务
$ gulp my_task$ gulp one_task two_task

参数标记

【作者：唐霜】著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net

未经授权，禁止复制转载。【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】

-v 或 –version 未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。会显示全局和项目本地所安装的 gulp 【转载请注明来源】【版权所有】唐霜 www.tangshuang.net版本号

【转载请注明来源】

【作者：唐霜】

【原创内容，转载请注明出处】

–require modul原创内容，盗版必究。【未经授权禁止转载】e_path 将会在执行之前 reqiu【本文首发于唐霜的博客】【作者：唐霜】re 一个模块。这对于一些语言编译器或者原创内容，盗版必究。转载请注明出处：www.tangshuang.net需要其他应用的情况来说来说很有用。你可以著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】使用多个–require

转载请注明出处：www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】

本文版权归作者所有，未经授权不得转载。

【原创内容，转载请注明出处】

–gulpfile gulp本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】file_path 手动指定一个 gul本文作者：唐霜，转载请注明出处。【作者：唐霜】pfile 的路径，这在你有很多个 gu著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】lpfile 的时候很有用。这也会将 C【本文受版权保护】【转载请注明来源】WD 设置到该 gulpfile 所在目【转载请注明来源】本文作者：唐霜，转载请注明出处。录

【未经授权禁止转载】

【本文首发于唐霜的博客】

【原创不易，请尊重版权】

【未经授权禁止转载】

–cwd dir_path 原创内容，盗版必究。原创内容，盗版必究。手动指定 CWD。定义gulpfile查著作权归作者所有，禁止商业用途转载。【作者：唐霜】找的位置，此外，所有的相应的依赖（req【关注微信公众号：wwwtangshuangnet】【转载请注明来源】uire）会从这里开始计算相对路径

未经授权，禁止复制转载。

【作者：唐霜】

-T 或 –tasks 会显著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。示所指定 gulpfile 的 task【转载请注明来源】原创内容，盗版必究。依赖树

【本文首发于唐霜的博客】

【未经授权禁止转载】

【本文受版权保护】

–tasks-simple 【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。会以纯文本的方式显示所载入的 gulpf【作者：唐霜】【版权所有，侵权必究】ile 中的 task 列表

【本文受版权保护】

【原创内容，转载请注明出处】

–color 强制 gulp【本文受版权保护】【版权所有】唐霜 www.tangshuang.net 和 gulp 插件显示颜色，即便没有颜【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。色支持

【原创内容，转载请注明出处】

著作权归作者所有，禁止商业用途转载。

【访问 www.tangshuang.net 获取更多精彩内容】

–no-color 强制不显本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】示颜色，即便检测到有颜色支持

转载请注明出处：www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】

–silent 禁止所有的转载请注明出处：www.tangshuang.net【本文受版权保护】gulp 日志

本文版权归作者所有，未经授权不得转载。

转载请注明出处：www.tangshuang.net

举个栗子：

$ gulp --gulpfile gulpfile.es6.js
$ gulp task
$ gulp --gulpfile gulpfile.js
$ gulp task

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

使用自己的参数

我知道你会想到一个问题，可不可以在执行g原创内容，盗版必究。【转载请注明来源】ulp任务的时候，传入参数？gulp默认【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。并没有支持这项功能，但这并不代表我们不可【关注微信公众号：wwwtangshuangnet】【本文受版权保护】以做到，因为我们可以使用其他的包来得到命【作者：唐霜】原创内容，盗版必究。令行中的参数。

在命令行中，一般短横线表示参数，但是不同本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。的软件不一样，比如下面这几种都经常看到：

未经授权，禁止复制转载。【作者：唐霜】【原创内容，转载请注明出处】

-v
--version-name 
my_name
--name my_name-name=my_name
--name=my_name

这些并没有统一的标准，但我个人而言，更倾【转载请注明来源】未经授权，禁止复制转载。向于-v和–name=my_【未经授权禁止转载】本文作者：唐霜，转载请注明出处。name这两种，第一种是缩写，比如-v实【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。际上表示的是-version，但用-v可【转载请注明来源】【未经授权禁止转载】以更加简单，而且用一个短横线表示这个参数【版权所有】唐霜 www.tangshuang.net【转载请注明来源】不需要值。第二种是两个短横线加参数名加等著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】号加参数值，这种表达方法非常直观，普通人【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。大部分都看得懂。基于这种想法，我使用了自著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net己写的process.args，你可以引用我写的这个模块，实现CLI参【本文受版权保护】【原创不易，请尊重版权】数的风格。

【未经授权禁止转载】原创内容，盗版必究。原创内容，盗版必究。

下面具体讲一下process.args的原创内容，盗版必究。【未经授权禁止转载】使用方法：

【作者：唐霜】【转载请注明来源】【作者：唐霜】

1）下载到本地

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。

$ git clone https://github.com/tangshuang/process.args.git

2）在gulpfile.js文件中引用它

【原创不易，请尊重版权】【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】

var args = require('./process.args')(true);
var gulp = require('gulp');
gulp.task('my_task',function() {
  if(args.d) {
    //...
  }
  
  if(!args.name) {
    console.log('There must be name.')
    return;
  }
  
  var name = args.name;
  
  console.log('Your name is ' + name);
});

3）在命令行中按照process.arg【原创内容，转载请注明出处】【原创不易，请尊重版权】s的规范使用参数进行执行

【作者：唐霜】原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。

$ gulp my_task -d --name="Nicok"

赶紧自己尝试一下吧。关于gulpfile【本文首发于唐霜的博客】【本文首发于唐霜的博客】的东西，会在下一节详细介绍。

gulpfile实例

gulpfile是什么呢？简单的说，它是【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】gulp命令的入口文件，当你在命令行里面转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】执行glup my_task的时候，实际著作权归作者所有，禁止商业用途转载。【本文受版权保护】上可以理解为执行node gulpfil【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。e.js my_task，当然，这只是有【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】利于你理解，实际上比这复杂一些。

【作者：唐霜】本文版权归作者所有，未经授权不得转载。

我们把这个gulpfile.js创建在项【本文受版权保护】转载请注明出处：www.tangshuang.net目的根目录下，这样就可以在项目中规定一些【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net我们自己的gulp任务，这些任务在gul【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。pfile.js里面进行注册，即gulp本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】.task，这会在下一章API里面讲到。

使用ES6

我们可以用gulpfile.babel.转载请注明出处：www.tangshuang.net【本文受版权保护】js代替gulpfile.js（直接重命【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。名即可），这样可以借助babel使用ES原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net6新特性，不过我们也需要在项目中安装ba转载请注明出处：www.tangshuang.net【转载请注明来源】bel：

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】

$ npm install --save-dev babel-core
$ npm install --save-dev babel-register
$ npm install --save-dev babel-preset-latest

在项目根目录下创建.babelrc文件，【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】内容如下：

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。

{
  "presets": ["latest"]
}

这样，就可以在gulpfile中使用ES本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】6代码。

【本文首发于唐霜的博客】【原创内容，转载请注明出处】

部署项目任务

有的时候，我们的项目任务比较复杂，不可能本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】通过一个gulpfile.js实现全部我【版权所有，侵权必究】【版权所有，侵权必究】们想要的任务功能，否则会让这个文件超级大【原创内容，转载请注明出处】【版权所有，侵权必究】。
【版权所有，侵权必究】这个时候，我们可能需要将不同的任务分到著作权归作者所有，禁止商业用途转载。【作者：唐霜】不同的文件模块中去。我的做法是创建一个g本文版权归作者所有，未经授权不得转载。【转载请注明来源】ulp目录，把所有的任务分割成一个一个的【本文受版权保护】【本文受版权保护】，每一个文件一个任务：

$ mkdir gulp/task$ vi gulp/task/add.js

在add.js中撰写任务流程。

本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】

var args = require('../../tools/process.args'); // 引入我们上一章中介绍的process.args
module.exports = function() {
  
  if(!args.name) {}
  
  ...};

未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】

var gulp = require('gulp');
gulp.task('add',require('./gulp/task/add'));

这样就可以将gulp任务进行分解，当你的【本文受版权保护】【原创内容，转载请注明出处】gulp任务特别多的时候，可以有效的进行【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。管理。

【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】

是不是已经有点感觉了，赶紧手动尝试一下吧未经授权，禁止复制转载。【作者：唐霜】。
【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

下一章，就将进入正式的gulp编程，你会著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】了解怎么样创建自己的gulp任务，以及怎本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。样部署代码。

本文版权归作者所有，未经授权不得转载。【作者：唐霜】原创内容，盗版必究。

任务

这一章将讲解如何创建gulp任务，如何执未经授权，禁止复制转载。【转载请注明来源】行它，如何撰写一个具有实际功能和处理流程【作者：唐霜】著作权归作者所有，禁止商业用途转载。的任务。

【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

创建任务

上一章已经讲到，单凭一个gulpfile【本文受版权保护】未经授权，禁止复制转载。是无法完成整个gulp流程管理的，大多数【作者：唐霜】著作权归作者所有，禁止商业用途转载。时候，我们都通过创建一堆有联系的、以gu【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.netlpfile为入口的js代码，以此构建复本文作者：唐霜，转载请注明出处。【作者：唐霜】杂的gulp管理体系。

上一章已经介绍了如何在gulpfile中【未经授权禁止转载】【原创内容，转载请注明出处】引入其他js文件作为具体任务的执行模块，转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】所以这里就不介绍了，我将直接具体的代码块本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】来讲清楚如何创建任务。

本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。【本文受版权保护】著作权归作者所有，禁止商业用途转载。

在gulp任务体系代码中这样进行任务的注转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net册：

【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】【未经授权禁止转载】

gulp.task('my_task',require('./tasks/my_task.js'));

这样就创建好了一个gulp任务，在命令行著作权归作者所有，禁止商业用途转载。【作者：唐霜】中，执行

$ gulp my_task

【转载请注明来源】【原创内容，转载请注明出处】

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

var gulp = require('glup');module.exports = function() {
  
  // do your task};

主体结构就这么简单，所有要执行的东西都写【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。在这个function里面。

本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】

如何和你的项目结合

但是讲了这么多，你可能还没搞清楚，你用g未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ulp到底为什么。实际上，gulp根本不【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】是你的目标，你只是在开发你自己的项目的时【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net候，把gulp作为一个工具，而不是为了写【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】一大堆gulp任务，你的项目才是主，gu【未经授权禁止转载】【作者：唐霜】lp只是辅助。举个栗子吧，你的项目里面会【原创内容，转载请注明出处】【原创不易，请尊重版权】不断的用一个模板去生成新的文件，但是每一【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】次生成的时候，都因为传入的参数不同而不同【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】。利用gulp就可以实现这个目的，在上面原创内容，盗版必究。【本文受版权保护】的function里面写上读取模板、构建【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net参数替换、输出到具体的文件等流程，这样就【未经授权禁止转载】本文作者：唐霜，转载请注明出处。实现了这个目的，但是最终，gulp这些东原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】西跟用户没关系，只有那些重复生成的文件才本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】是用户最后要用的。

未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

gulp比较厉害的，是可以自动去执行一些本文作者：唐霜，转载请注明出处。【作者：唐霜】代码，后面一章我们会具体将gulp的ap【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.neti，这一章我们主要讲你应该怎么使用api本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。，知道怎么使用了，下一章再知道都有哪些a转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。pi，将快速掌握gulp。

比如，我们现在得到一个gulp的api：【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。gulp.dest，这个api的功能是用【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。来输出内容到某个文件的。

pipe（管道）这个概念

gulp里面有一个非常有名的概念，叫“管本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。道”，也就是pipe，但它不直接作用于g未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。ulp，而是要作用于其他结果上。

转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。【本文受版权保护】【作者：唐霜】

pipe是node中的一个概念，可以处理本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。Stream，而gulp.src这个ap【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】i恰巧输出的是vinyl files的s【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。tream，因此可以用pipe来进行处理【本文受版权保护】【原创不易，请尊重版权】。
【本文首发于唐霜的博客】 pipe是gulp和grunt的一个重【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。大区别，关于两则的区别，会在专门的章节讲【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。到。它就像一根一根的管道，东西从这个口进【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net去，下个口出来，样子就变了，再进入下一个【本文受版权保护】【本文首发于唐霜的博客】管道，出来又继续变，所以gulp里面的经【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。典用法如下：

gulp.src('./client/templates/*.jade')
  .pipe(jade())
  .pipe(gulp.dest('./build/templates'))
  .pipe(minify())
  .pipe(gulp.dest('./build/minified_templates'));

这个pipe可以连续不断的使用，前面一个【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。pipe处理之后的结果，将作为下一个pi【本文受版权保护】本文作者：唐霜，转载请注明出处。pe处理的开端。取出.pipe(gulp【版权所有】唐霜 www.tangshuang.net【转载请注明来源】.dest(‘./build原创内容，盗版必究。本文作者：唐霜，转载请注明出处。/xxx’))这一节管道来讲【作者：唐霜】【本文首发于唐霜的博客】一下：

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】【原创不易，请尊重版权】未经授权，禁止复制转载。

gulp.dest是一个api，但是它只原创内容，盗版必究。【本文受版权保护】有一个参数，告诉程序处理结果将输出到&#著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】8217;./build/xxxR本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】17;这个文件，但是要输出什么内容呢？要【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net输出的内容来自上一个pipe。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】未经授权，禁止复制转载。

再来说下pipe(minify())这个【版权所有，侵权必究】【原创内容，转载请注明出处】管道，minify来自一个gulp插件，未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】需要在项目中执行npm install 原创内容，盗版必究。【本文受版权保护】gulp-minify-css R【未经授权禁止转载】原创内容，盗版必究。11;save-dev。这根管道都干了什【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】么呢？将上一个pipe的结果（被放在了内本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。存中）交给minify这个插件，插件处理【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。完之后，就进入下一个管道。

【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】

逻辑处理

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

module.exports = function() {
  copy(from,to);
  minify(from,to);
};

上面的copy, minify是我自己乱本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。写的两个函数，只是为了说明，你可以不用g【作者：唐霜】【版权所有，侵权必究】ulp的api也可以使用简单的js逻辑代著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。码完成任务，只不过后面你学到watch的未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net时候，就会考虑使用gulp。

【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。

现在动手写一个操作文件的gulp任务吧。
【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。

本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

下一章介绍gulp的api。

API

这一章介绍gulp的所有api，现在来看【转载请注明来源】转载请注明出处：www.tangshuang.net，gulp的api一共就4个：gulp.【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.netsrc, gulp.dest, gulp【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。.task, gulp.watch. 之【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】前还有gulp.run等api，可以用来未经授权，禁止复制转载。【本文首发于唐霜的博客】在一个task中去触发另外一个task，本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】但是现在这个api被去掉了，因为有了新的转载请注明出处：www.tangshuang.net【作者：唐霜】依赖替代方案，在讲gulp.task这一【未经授权禁止转载】【原创不易，请尊重版权】节的时候会详细去说。

本文版权归作者所有，未经授权不得转载。【作者：唐霜】

gulp.src 获得所有符合条件的文件【未经授权禁止转载】【未经授权禁止转载】信息

著作权归作者所有，禁止商业用途转载。

原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。

【原创内容，转载请注明出处】

gulp.dest 将信息输出到某个文件

【访问 www.tangshuang.net 获取更多精彩内容】

【本文受版权保护】

著作权归作者所有，禁止商业用途转载。

gulp.task 注册一个gulp任务

著作权归作者所有，禁止商业用途转载。

本文作者：唐霜，转载请注明出处。

gulp.watch 监听文件变化

【转载请注明来源】

原创内容，盗版必究。

gulp.src

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。【作者：唐霜】本文版权归作者所有，未经授权不得转载。

用法

gulp.src(globs[, options])

gulp.src('client/templates/*.jade')
  .pipe(jade())
  .pipe(minify())
  .pipe(gulp.dest('build/minified_templates'));

参数

globs

描述：所要读取的 glob 或者包含 g【转载请注明来源】原创内容，盗版必究。lobs 的数组。
本文版权归作者所有，未经授权不得转载。类型： String 或 Array
本文作者：唐霜，转载请注明出处。 glob 请参考 node-glob 语法或者，你也可以直接写文件的路径。

options

描述：通过 glob-stream 所传【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】递给 node-glob 的参数。
【转载请注明来源】类型： Object

除了 node-glob 和 glob-stream 所支持的参数外，gulp 增加了一些额外本文版权归作者所有，未经授权不得转载。【转载请注明来源】的选项参数：

【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】

options.buffer

著作权归作者所有，禁止商业用途转载。【作者：唐霜】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

描述：是否返回buffer，或者说是返回【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。buffer（true）还是返回file【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】_contents（false）。
【作者：唐霜】类型： Boolean
【原创内容，转载请注明出处】默认值： true

【作者：唐霜】【作者：唐霜】

如果该项被设置为 false，那么将会以本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】 stream 方式返回 file.co【原创不易，请尊重版权】【本文受版权保护】ntents 而不是文件 buffer 【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。的形式。这在处理一些大文件的时候将会很有本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。用。注意：插件可能并不会实现对 stre原创内容，盗版必究。【版权所有，侵权必究】am 的支持。

原创内容，盗版必究。【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】

options.read

转载请注明出处：www.tangshuang.net【转载请注明来源】

描述：是否去读取文件的内容。
本文版权归作者所有，未经授权不得转载。类型： Boolean
未经授权，禁止复制转载。默认值： true

本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

如果该项被设置为 false，那么 f原创内容，盗版必究。转载请注明出处：www.tangshuang.netile.contents 会返回空值（n【本文首发于唐霜的博客】【本文受版权保护】ull），也就是并不会去读取文件。

【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

options.base

【未经授权禁止转载】未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

描述：重新指定src的base，不好理解【版权所有，侵权必究】【作者：唐霜】，具体看下面的解释。
著作权归作者所有，禁止商业用途转载。类型： String
原创内容，盗版必究。默认值：将会加在 glob 之前 (原创内容，盗版必究。【本文首发于唐霜的博客】请看 glob2base)

请想像一下在一个路径为 client/j【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。s/somedir 的目录中，有两个文件原创内容，盗版必究。【未经授权禁止转载】：1.js，2.js ，现在我们这样：

著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。

gulp.src('client/js/**/*.js')

上面匹配的结果是什么呢？会得到两个文件的【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】路径和内容，路径是client/js/s【转载请注明来源】著作权归作者所有，禁止商业用途转载。omedir/1.js和client/j本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。s/somedir/2.js，但对于gu【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】lp而言，这个时候的base是clien【未经授权禁止转载】【原创内容，转载请注明出处】/js/，也就是glob开始匹配之前的字未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】符串。

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。【转载请注明来源】

如果不规定options.base，那么【转载请注明来源】原创内容，盗版必究。在后面的pipe中，就会以options【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。.base=’client/【转载请注明来源】未经授权，禁止复制转载。js/’进行处理，比如我们在【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net末尾执行.pipe(gulp.dest(【本文首发于唐霜的博客】【转载请注明来源】‘dist/name/【原创内容，转载请注明出处】【转载请注明来源】217;))，那么会得到两个文件：dis【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。t/name/somedir/1.js和【原创内容，转载请注明出处】【本文受版权保护】dist/name/somedir/2.【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】js。

但是有的时候我们想要的是dist/nam未经授权，禁止复制转载。转载请注明出处：www.tangshuang.nete/js/somedir/1.js，而不著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net是上面的文件路径。这个时候options【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。.base就可以派上用场。

【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】

gulp.src('client/js/**/*.js',{
  base: 'client'
}).pipe(gulp.dest('dist/name'))

这样就可以得到想要的结果。

它这里面就有一个相对路径的感觉，比如它找本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】到了client/js/somedir/【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】1.js，但是你设置了base字段为cl原创内容，盗版必究。原创内容，盗版必究。ient，所以它就会把client这个目本文版权归作者所有，未经授权不得转载。【转载请注明来源】录层级从client/js/somedi【作者：唐霜】【原创内容，转载请注明出处】r/1.js中移除，剩下的部分就是js/【本文首发于唐霜的博客】【本文受版权保护】somedir/1.js，把这个部分放到【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】dest规定的目录中去。

这就是gulp.src，赶紧动手去自己试未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。试吧。

gulp.dest

能被 pipe 进来（实际上，只能在pi【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netpe中使用，因为它没有参数用于传入文件来【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】源），并且将会写文件。并且重新输出（em本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。its）所有数据，因此你可以将它 pip【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。e 到多个文件夹。如果某文件夹不存在，将【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。会自动创建它。

用法

gulp.dest(path[, options])

gulp.src('./client/templates/*.jade')
  .pipe(jade())
  .pipe(gulp.dest('./build/templates'))
  .pipe(minify())
  .pipe(gulp.dest('./build/minified_templates'));

参数

path

描述：要输出到哪个目录中。
转载请注明出处：www.tangshuang.net 类型： String or Funct转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】ion

【作者：唐霜】【本文受版权保护】原创内容，盗版必究。

文件将被写入的路径（输出目录）。也可以传【版权所有，侵权必究】【本文首发于唐霜的博客】入一个函数，在函数中返回相应路径，这个函【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。数也可以由 vinyl 文件实例来提供转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net。
【版权所有】唐霜 www.tangshuang.net 文件被写入的路径是以所给的相对路径根据【作者：唐霜】未经授权，禁止复制转载。所给的目标目录计算而来。类似的，相对路径转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】也可以根据所给的 base 来计算。请【作者：唐霜】本文版权归作者所有，未经授权不得转载。查看上述的 gulp.src 来了解更多本文作者：唐霜，转载请注明出处。【作者：唐霜】信息。

未经授权，禁止复制转载。未经授权，禁止复制转载。

options

描述：传入一些附加参数
【转载请注明来源】类型： Object

【本文首发于唐霜的博客】原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】

options.cwd

未经授权，禁止复制转载。【原创不易，请尊重版权】未经授权，禁止复制转载。

描述：以哪个目录作为输出的当前目录。
【作者：唐霜】类型： String
【作者：唐霜】默认值： process.cwd() 【转载请注明来源】【未经授权禁止转载】（命令执行时所在的目录，一般而言，是gu未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。lpfile所在的目录）

输出目录的 cwd 参数，只在所给的输出【本文首发于唐霜的博客】【原创内容，转载请注明出处】目录是相对路径时候有效。什么意思呢？举未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。个栗子：

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net

.pipe(gulp.dest('dist',{
  cwd: 'components/'
}))

如果没有cwd的话，dist目录会和gu本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。lpfile同级，但现在dist目录会在本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】components目录下面，compo著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.netnents目录如果不存在的话会被自动创建本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

options.mode

【原创内容，转载请注明出处】【本文受版权保护】【原创内容，转载请注明出处】

描述：八进制权限字符，用以定义所有在输出【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】目录中新创建的目录的权限。
【本文受版权保护】类型： String
本文版权归作者所有，未经授权不得转载。默认值： 0777

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。未经授权，禁止复制转载。

gulp.task

定义一个使用 Orchestrator 实现的任务（task）。

未经授权，禁止复制转载。未经授权，禁止复制转载。

我看了一下Orchestrator，感觉原创内容，盗版必究。本文作者：唐霜，转载请注明出处。它就是一个专门处理任务的模块，gulp应【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net该是用了它的部分功能。它在task的功能未经授权，禁止复制转载。【本文首发于唐霜的博客】上，比gulp.task齐全，可以add【作者：唐霜】【本文首发于唐霜的博客】, start, stop, hasTa【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】sk, on, onAll这些api。玩【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。儿过jquery的对on的机制应该都不陌【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】生。但是gulp.task感觉只是它的a【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】dd功能。

【转载请注明来源】【原创不易，请尊重版权】【作者：唐霜】

用法

gulp.task(name[, deps], fn)

gulp.task('somename', function() {
  // 做一些事
});

参数

name

描述：任务的名字，如果你需要在命令行中运本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】行你的某些任务，那么，请不要在名字中使用本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】空格。
本文版权归作者所有，未经授权不得转载。类型：String

deps

gulp.task('mytask', ['array', 'of', 'task', 'names'], function() {
  // 做一些事
});

注意：你的任务是否在这些前置依赖的任务【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。完成之前运行了？请一定要确保你所依赖的任【原创内容，转载请注明出处】未经授权，禁止复制转载。务列表中的任务都使用了正确的异步执行方式原创内容，盗版必究。【作者：唐霜】：使用一个 callback，或者返回一【未经授权禁止转载】本文作者：唐霜，转载请注明出处。个 promise 或 stream。

原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】

fn

描述：该函数定义任务所要执行的一些操作。
本文作者：唐霜，转载请注明出处。类型：Function

原创内容，盗版必究。【原创不易，请尊重版权】【原创内容，转载请注明出处】

通常来说，它的内部会是这种形式：gulp转载请注明出处：www.tangshuang.net【未经授权禁止转载】.src().pipe(someplug【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】in())。

未经授权，禁止复制转载。未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

异步任务支持

【本文首发于唐霜的博客】【作者：唐霜】【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

任务可以异步执行，如果 fn 能做到以下【本文受版权保护】著作权归作者所有，禁止商业用途转载。其中一点：

接受一个 callback

本文版权归作者所有，未经授权不得转载。

【转载请注明来源】

未经授权，禁止复制转载。

// 在 shell 中执行一个命令var exec = require('child_process').exec;
gulp.task('jekyll', function(cb) {
  // 编译 Jekyll
  exec('jekyll build', function(err) {
    if (err) return cb(err); // 返回 error
    cb(); // 完成 task
  });
});

注意上面的cb（callback）是一个【转载请注明来源】本文版权归作者所有，未经授权不得转载。函数，它被作为参数传给了gulp.tas本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。k的第二个参数（是个函数）。

转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】

返回一个 stream

原创内容，盗版必究。

本文作者：唐霜，转载请注明出处。

原创内容，盗版必究。

【本文受版权保护】

gulp.task('somename', function() {
  var stream = gulp.src('client/**/*.js')
    .pipe(minify())
    .pipe(gulp.dest('build'));
  return stream;
});

返回一个 promise

【访问 www.tangshuang.net 获取更多精彩内容】

【作者：唐霜】

未经授权，禁止复制转载。

本文版权归作者所有，未经授权不得转载。

var Q = require('q');
gulp.task('somename', function() {
  var deferred = Q.defer();
  // 执行异步的操作
  setTimeout(function() {
    deferred.resolve();
  }, 1);
  return deferred.promise;
});

Promise是javascript中一【关注微信公众号：wwwtangshuangnet】【转载请注明来源】个非常重要的概念，如果你不知道的话，可以转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。阅读一下我写过的一篇文章有一个基本的概念。

转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。

注意：默认的，task 将以最大的并发【原创不易，请尊重版权】【原创不易，请尊重版权】数执行，也就是说，gulp 会一次性运行本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。所有的 task 并且不做任何等待。如果【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net你想要创建一个序列化的 task 队列，【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。并以特定的顺序执行，你需要做两件事：

【原创内容，转载请注明出处】【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】

给出一个提示，来告知 task 什么时候【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。执行完毕，

【关注微信公众号：wwwtangshuangnet】

并且再给出一个提示，来告知一个 task【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】依赖另一个 task 的完成。

本文版权归作者所有，未经授权不得转载。

原创内容，盗版必究。

本文版权归作者所有，未经授权不得转载。

在 “one” 【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net中，你加入一个提示，来告知什么时候它会完转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。成：可以再完成时候返回一个 callba本文作者：唐霜，转载请注明出处。【作者：唐霜】ck，或者返回一个 promise 或【作者：唐霜】本文作者：唐霜，转载请注明出处。stream，这样系统会去等待它完成。

转载请注明出处：www.tangshuang.net

本文作者：唐霜，转载请注明出处。

在 “two” 著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。中，你需要添加一个提示来告诉系统它需要依著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】赖第一个 task 完成。

【转载请注明来源】

本文作者：唐霜，转载请注明出处。

因此，这个例子的实际代码将会是这样：

著作权归作者所有，禁止商业用途转载。【作者：唐霜】

var gulp = require('gulp');
// 返回一个 callback，因此系统可以知道它什么时候完成
gulp.task('one', function(cb) {
  
  // 做一些事 -- 异步的或者其他的
  
  cb(err); // 如果 err 不是 null 或 undefined，则会停止执行，且注意，这样代表执行失败了
});
// 定义一个所依赖的 task 必须在这个 task 执行之前完成
gulp.task('two', ['one'], function() {
  // 'one' 完成后
});
gulp.task('default', ['one', 'two']);

其实简单的说，就是虽然在default这转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】个任务中，one和two是不分顺序的，但【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】是在two这个任务中，需要依赖one这个原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。任务，所以实际上，当default中的o【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netne和two同时开始执行的时候，two并【本文首发于唐霜的博客】原创内容，盗版必究。不会马上执行，而是要等到one执行的ok本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】的时候再执行。

回调函数

【本文受版权保护】本文作者：唐霜，转载请注明出处。

上面的例子中，多次出现了cb这个回调函数【关注微信公众号：wwwtangshuangnet】【转载请注明来源】，它是用来干嘛的，代表什么？

【未经授权禁止转载】【未经授权禁止转载】

其实这个回调函数并不做任何操作意义上的事【本文受版权保护】原创内容，盗版必究。，而是用来通知gulp这个task完成了【转载请注明来源】【版权所有】唐霜 www.tangshuang.net，不管完成的怎么样，任务已经可以被忽略了【版权所有，侵权必究】【版权所有，侵权必究】。我更愿意把它称为done(fail)，【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】其中的参数如果是null或undefin【原创不易，请尊重版权】转载请注明出处：www.tangshuang.neted，则表示成功了，否则表示失败了，里面【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】的内容就是告诉gulp失败的信息。

gulp.task('my_task',function(done){
  var data = request();
  if(data.error) {
    done(data.msg)
  }
  else {
    done();
  }
  
  // .. other code ..
});

在done()后面其实还可以执行其他的代【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。码，因为done不是return，程序不本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。会停止执行。但是对于gulp.task而本文作者：唐霜，转载请注明出处。【转载请注明来源】言，它已经接收到任务执行情况的信息了，后【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】面的执行对它来说没什么意义，随便你怎么做本文作者：唐霜，转载请注明出处。原创内容，盗版必究。都可以。

原创内容，盗版必究。【原创内容，转载请注明出处】【转载请注明来源】原创内容，盗版必究。

这也就是为什么上面说如果要让b任务依赖a【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。任务，要给ａ任务传一个done作为回调函著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。数的原因。因为当b任务开始被执行时，其实本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】先是等待状态，要让a先执行，但是等待归等本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。待，你总得告诉我什么时候开始执行吧，这个【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】“告诉”动作就是done函数，只要在任务【版权所有】唐霜 www.tangshuang.net【作者：唐霜】执行过程中执行了done函数，就相当于告【作者：唐霜】本文版权归作者所有，未经授权不得转载。诉b可以开始执行了。

ok，关于gulp的task这个api就本文作者：唐霜，转载请注明出处。【作者：唐霜】介绍完了，赶紧去自己实践一下。

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】【本文受版权保护】

gulp.watch

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。

用法

gulp.watch(glob [, opts], tasks)gulp.watch(glob [, opts, cb])

它有两种用法，下面分开讲解。

【转载请注明来源】原创内容，盗版必究。原创内容，盗版必究。

gulp.watch(glob[, opts], tasks)

【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。

glob

描述：要监听的文件。
【作者：唐霜】类型： String or Array
【版权所有】唐霜 www.tangshuang.net 一个 glob 字符串，或者一个包含多未经授权，禁止复制转载。【版权所有，侵权必究】个 glob 字符串的数组，用来指定具体原创内容，盗版必究。未经授权，禁止复制转载。监控哪些文件的变动。

【关注微信公众号：wwwtangshuangnet】【转载请注明来源】

opts

类型： Object

【原创内容，转载请注明出处】原创内容，盗版必究。

传给gaze的参数。什么是gaze呢？这个项目已经【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。被原作者删掉了，我通过其他的一些资料了解【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。到，它其实是一个监听文件变动的模块，gu【转载请注明来源】本文版权归作者所有，未经授权不得转载。lp应该也是使用了这个包。

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。

从使用上看，我还没有看到怎么用opts这【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。个参数，好像大部分情况都不会用到。我感觉著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。应该是指在什么情况下才执行tasks，比【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。如只有在文件被删除的情况下执行task，【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。或者在文件被修改或删除的时候执行。总之我转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。感觉这个opts是用来填写下面的even【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。t.type的。

【原创不易，请尊重版权】【转载请注明来源】著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。

tasks

描述：要执行的任务列表
【关注微信公众号：wwwtangshuangnet】类型： Array
【未经授权禁止转载】需要在文件变动后执行的一个或者多个通过【原创内容，转载请注明出处】【版权所有，侵权必究】 gulp.task() 创建的 tas著作权归作者所有，禁止商业用途转载。【作者：唐霜】k 的名字，

【本文首发于唐霜的博客】【原创不易，请尊重版权】原创内容，盗版必究。未经授权，禁止复制转载。

gulp.watch('js/**/*.js', ['uglify','reload']);

gulp.watch(glob[, opts, callback])

监听（单个或多个）文件的变动，一旦有变，本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。就执行callback这个回调函数。

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

glob

描述：要监听的文件。
【转载请注明来源】类型： String or Array
【作者：唐霜】一个 glob 字符串，或者一个包含多【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net个 glob 字符串的数组，用来指定具体【未经授权禁止转载】原创内容，盗版必究。监控哪些文件的变动。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

opts

类型： Object
【关注微信公众号：wwwtangshuangnet】传给 gaze 的参数。

本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。

callback(event)

描述：文件变动时要执行的回调函数。
转载请注明出处：www.tangshuang.net 类型： Function

gulp.watch('js/**/*.js', function(event) {
  console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
});

转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】

event.type

类型： String
【访问 www.tangshuang.net 获取更多精彩内容】发生的变动的类型：added, cha著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。nged 或者 deleted。

【转载请注明来源】【未经授权禁止转载】

event.path

原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】【转载请注明来源】

类型： String
著作权归作者所有，禁止商业用途转载。触发了该事件的文件的路径。

gulp.watch的返回值

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】

var watcher = gulp.watch('js/**/*.js', ['uglify','reload']);
watcher.on('change', function(event) {
  console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
});

回调函数会在change事件的末尾执行。【本文受版权保护】原创内容，盗版必究。回调函数的event和上面的event是转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】一样的。实际上，我们采用gulp.wat未经授权，禁止复制转载。【版权所有，侵权必究】ch(files,function(e)【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】{})和用on再去挂载是差不多的。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

gulp.watch是作为一个自动化控制未经授权，禁止复制转载。【作者：唐霜】的最主要的特性，也是提高我们工作效率的重【本文受版权保护】【关注微信公众号：wwwtangshuangnet】要助手，应该多写一些例子来锻炼一下。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

插件的使用

本章主要讲解在gulp的体系里，插件是个【未经授权禁止转载】未经授权，禁止复制转载。什么概念，可以怎么使用，都有哪些常用的有未经授权，禁止复制转载。【未经授权禁止转载】必要介绍的插件。以及会在这些具体的插件介著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。绍里，简单的介绍插件如何使用。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【本文受版权保护】

由于篇幅的限制，本章不会对每一个插件最非【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】常详细的介绍，作为开发者，最好的办法就是【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】去插件的主页或github查看原始文档，【本文首发于唐霜的博客】【原创不易，请尊重版权】甚至通过阅读源码来了解插件原理，从而更好转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net的使用插件。

概念

【本文首发于唐霜的博客】【原创不易，请尊重版权】

gulp插件，其实还是一个npm包，只不【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。过这个npm包是提供给gulp用的，但不【版权所有】唐霜 www.tangshuang.net【本文受版权保护】一定要依赖gulp。gulp比grunt【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。有一点好处就是，gulp是干净的，本身只原创内容，盗版必究。本文作者：唐霜，转载请注明出处。有几个并不强大的api，借助管道机制，不【转载请注明来源】未经授权，禁止复制转载。需要繁琐的配置。插件是决定gulp功能强【原创不易，请尊重版权】【作者：唐霜】大的机制。
转载请注明出处：www.tangshuang.net 插件从功能上讲，就是对原始体系的补充。

原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】

但是从npm包的角度而言，并不是只有gu【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netlp插件可以用到gulp中，所有的包都可【原创不易，请尊重版权】【转载请注明来源】以用进来，只要它可以在node环境中运行【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】，你都可以require到gulpfil【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。e的体系里面使用。

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。本文作者：唐霜，转载请注明出处。

到哪里去找插件

【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。【作者：唐霜】

直接在npm官网搜索既可以了。https://www.npmjs.co【本文受版权保护】转载请注明出处：www.tangshuang.netm/browse/keyword/gul【本文首发于唐霜的博客】【转载请注明来源】p

继续往下读，我会带你一点点了解怎么使用插【未经授权禁止转载】转载请注明出处：www.tangshuang.net件，大部分情况下都是熟能生巧，多用用，插未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。件的东西就心领神会了。
著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】

【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。【作者：唐霜】【作者：唐霜】

使用插件通用性方法

gulp.src(xxx).pipe(plugin)...

我们来举例子：gulp-uglify

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【转载请注明来源】【未经授权禁止转载】

未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。

$ npm install --save-dev gulp-uglify

然后在gulpfile体系的js中这样使原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。用：

【转载请注明来源】【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】【本文受版权保护】

var gulp = require('gulp');var uglify = require('gulp-uglify');
gulp.task('my_task',function(){
  gulp.src('js/**/*.js')
    .pipe(uglify())
    .pipe(gulp.dest('build'));
});

一般一个插件都先通过require返回一【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】个函数，这个函数主要用在pipe中，也就本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。是说不需要传入要处理什么东西，而是会传入原创内容，盗版必究。【原创内容，转载请注明出处】一些options。

【本文首发于唐霜的博客】【未经授权禁止转载】未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】

在使用的时候，大部分情况都是直接把这个函【原创不易，请尊重版权】【原创不易，请尊重版权】数作为pipe()的参数传入即可。

原创内容，盗版必究。【转载请注明来源】【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

js预编译

我们通常写js都是写符合ES标准的Jav【本文首发于唐霜的博客】【作者：唐霜】aScript代码，但是就像其他语言一样原创内容，盗版必究。【原创不易，请尊重版权】，我们可以用其他语言来写代码，再通过编译著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】得到可以被执行的js代码，借助一些解释器本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。，可以不用编译为js就可以直接执行。目前【作者：唐霜】【未经授权禁止转载】比较知名的有CoffeeScript和T【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】ypeScript，Coffee比较成熟著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。，而且借鉴了声明式和ruby的很多风格，本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】TypeScript是微软开发的，这两年【原创内容，转载请注明出处】【转载请注明来源】刚热，不够成熟，但是据说谷歌用TypeS【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。cript写了angular2.0，这可【作者：唐霜】【原创不易，请尊重版权】能将推动TypeScript超越Coff著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】ee。

不过从目前公认的情况看，Coffee还是著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。比TypeScript的用户多，得到的认原创内容，盗版必究。未经授权，禁止复制转载。可度也高，只不过这两年人气稍有下降。

gulpfile.coffee

如果你想在编写gulpfile体系时使用【作者：唐霜】【本文受版权保护】coffee，可以这样做：

$ npm install coffee-script --save-dev

然后将gulpfile.js改为gulp【本文受版权保护】本文版权归作者所有，未经授权不得转载。file.coffee，这样在gulpf【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。ile体系里面，就使用coffee进行编【转载请注明来源】未经授权，禁止复制转载。写。

gulp-coffee

这是gulp的一个插件，它是用来把你项目【转载请注明来源】【作者：唐霜】里面的.coffee文件编译为.js文件【原创内容，转载请注明出处】【作者：唐霜】的。

【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

npm install gulp-coffee --save-dev

文档：https://github.com/c本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netontra/gulp-coffee
本文版权归作者所有，未经授权不得转载。使用：

【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】【本文受版权保护】

var coffee = require('gulp-coffee');
gulp.src('./coffee/*.coffee')
  .pipe(coffee())
  .pipe(gulp.dest('./js/'))

本文作者：唐霜，转载请注明出处。【作者：唐霜】

js压缩

我们写完js代码之后，希望把代码进行压缩本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】，最后提供一个.min.js文件。

gulp-uglify

文档：https://www.npmjs.co【本文首发于唐霜的博客】【未经授权禁止转载】m/package/gulp-uglif【本文首发于唐霜的博客】【作者：唐霜】y

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

这个插件是gulp里面最常用来压缩js文【未经授权禁止转载】【作者：唐霜】件的

【作者：唐霜】【未经授权禁止转载】

$ npm install gulp-uglify --save-dev

var uglify = require('gulp-uglify');
glup.src('...')
  
  .pipe(uglify())
  
  .pipe(gulp.dest(...))

这样就可以把你写的代码压缩到目录中去了。

gulp-rename

文档：https://www.npmjs.co【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】m/package/gulp-renam【未经授权禁止转载】未经授权，禁止复制转载。e

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

这个插件可以重命名文件

转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】

$ npm install gulp-rename --save-dev

var gulp = require('gulp'); // 基础库
var uglify = require('gulp-uglify'), // js压缩
  rename = require('gulp-rename'); // 文件重命名
gulp.task('script', function() {
  return gulp.src('src/js/*.js') // 指明源文件路径、并进行文件匹配
    .pipe(rename({ suffix: '.min' })) // 重命名
    .pipe(uglify({ preserveComments:'some' })) // 使用uglify进行压缩，并保留部分注释
    .pipe(gulp.dest('dist/js')); // 输出路径
});

结合uglify，我们可以非常方便的就实未经授权，禁止复制转载。未经授权，禁止复制转载。现了生成min.js。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】

后面我们还会讲到将多个文件合并为一个文件【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。。

【本文首发于唐霜的博客】【作者：唐霜】【原创不易，请尊重版权】

css预编译

前面讲了js的预编译，情况差不多，我们也【转载请注明来源】【本文首发于唐霜的博客】可以通过其他语言先写出一种程序，在编译成著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。css提供给浏览器使用。

目前最流行的也有两种less和sass(著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netscss)。scss是sass的3.0版本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。本，但是写法完全不同，scss更接近cs本文作者：唐霜，转载请注明出处。【作者：唐霜】s的风格，推荐使用。

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

gulp-less

文档：https://www.npmjs.co本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】m/package/gulp-less

【原创内容，转载请注明出处】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。

$ npm install gulp-less --save-dev

var less = require('gulp-less');
var path = require('path');
gulp.task('less', function () {
  return gulp.src('./less/**/*.less')
    .pipe(less({
      paths: [ path.join(__dirname, 'less', 'includes') ]
    }))
    .pipe(gulp.dest('./public/css'));
});

gulp-sass

文档：https://www.npmjs.co【本文受版权保护】著作权归作者所有，禁止商业用途转载。m/package/gulp-sass

原创内容，盗版必究。【原创内容，转载请注明出处】

把.sass编译成.css

npm install gulp-sass --save-dev

var gulp = require('gulp');
var sass = require('gulp-sass');
gulp.task('sass', function () {
  return gulp.src('./sass/**/*.scss')
    .pipe(sass().on('error', sass.logError))
    .pipe(gulp.dest('./css'));
});
gulp.task('sass:watch', function () {
  gulp.watch('./sass/**/*.scss', ['sass']);
});

gulp-scss

用法其实一样，只不过是专门针对.scss原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。的，其实.sass和.scss是一个东西著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。，可以被同一个编译器编译，所以实际上上面【原创不易，请尊重版权】原创内容，盗版必究。的是gulp-sass也应该是可以编译.【原创不易，请尊重版权】【本文受版权保护】scss的。

【原创内容，转载请注明出处】【本文受版权保护】著作权归作者所有，禁止商业用途转载。

而且这个插件的作者不再推荐大家使用这个插【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。件。

著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。

gulp-ruby-sass

这个插件也是和gulp-sass差不多功著作权归作者所有，禁止商业用途转载。【转载请注明来源】能，你可以看下文档：https://www.npmjs.co【本文受版权保护】【转载请注明来源】m/package/gulp-ruby-【本文受版权保护】【本文受版权保护】sass

安装sass的一些问题

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。【转载请注明来源】

sass是基于ruby的，也就是说你的电【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】脑上得安装ruby。安装的时候还要在你的【转载请注明来源】【未经授权禁止转载】系统环境变量中加入ruby的PATH。在本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。windows上安装node-sass也著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。是个经常被吐槽的事情。可以使用淘宝镜像安【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。装，具体看这里。

文件合并

写完js之后，想把他们合并为一个文件。

【原创不易，请尊重版权】【未经授权禁止转载】

gulp-concat

文档：https://www.npmjs.co【原创不易，请尊重版权】【原创不易，请尊重版权】m/package/gulp-conca本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.nett

这个插件的作用是将多个js文件合并为一个【未经授权禁止转载】【转载请注明来源】js文件。

npm install --save-dev gulp-concat

用法

concat([string],[object])

var concat = require('gulp-concat');
gulp.task('scripts', function() {
  return gulp.src('./lib/*.js')
    .pipe(concat('all.js'))
    .pipe(gulp.dest('./dist/'));
});

参数

string

如果它的第一个参数是string类型，那本文版权归作者所有，未经授权不得转载。【转载请注明来源】么直接把这个string作为合并生成的文【本文受版权保护】本文版权归作者所有，未经授权不得转载。件名。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

object

{
  cwd: '', // 相对位置
  newLine: ';', // 换行的时候添加
  path: 'xxx.js', // 输出文件
  stat: {
    mode: 0666 // 文件的权限
  }
}

举个例子：

【本文受版权保护】【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

var concat = require('gulp-concat');
gulp.task('scripts', function() {
  return gulp.src(['./lib/file3.js', './lib/file1.js', './lib/file2.js'])
    .pipe(concat({ path: 'new.js', stat: { mode: 0666 }}))
    .pipe(gulp.dest('./dist'));
});

gulp-sourcemaps

var gulp = require('gulp');
var concat = require('gulp-concat');
var sourcemaps = require('gulp-sourcemaps');
gulp.task('javascript', function() {
  return gulp.src('src/**/*.js')
    .pipe(sourcemaps.init())
    .pipe(concat('all.js'))
    .pipe(sourcemaps.write())
    .pipe(gulp.dest('dist'));
});

css压缩

写完CSS，或者用Scss编译成css之本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。后，想把css进行压缩。

gulp-clean-css

文档：https://github.com/s本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】cniro/gulp-clean-css

$ npm install gulp-clean-css --save-dev

用法

cleanCSS([options], [callback])

参数

options

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】

要知道options怎么用，还要看CleanCSS的原始文档，原来npm的世界里都是依赖来转载请注明出处：www.tangshuang.net【未经授权禁止转载】依赖去，一个包的核心功能，可能仅仅是对另【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。外一个包的演进，或者多个包的整合，实际上【版权所有，侵权必究】【本文受版权保护】gulp也是对多个包的整合，在给自己披上原创内容，盗版必究。【原创不易，请尊重版权】了一层壳而已。

【原创不易，请尊重版权】未经授权，禁止复制转载。

var gulp = require('gulp');
var cleanCSS = require('gulp-clean-css');
gulp.task('minify-css', function() {
  return gulp.src('styles/*.css')
    .pipe(cleanCSS({compatibility: 'ie8'}))
    .pipe(gulp.dest('dist'));
});

callback

回调函数。

本文作者：唐霜，转载请注明出处。【转载请注明来源】

回调函数的参数是minify()的结果，【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。它会包含minified的文件信息。举个著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】例子：

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

var gulp = require('gulp');
var cleanCSS = require('gulp-clean-css');
gulp.task('minify-css', function() {
  return gulp.src('styles/*.css')
    .pipe(cleanCSS({debug: true}, function(details) {
      console.log(details.name + ': ' + details.stats.originalSize);
      console.log(details.name + ': ' + details.stats.minifiedSize);
    }))
    .pipe(gulp.dest('dist'));
});

而且Source Maps也能被gulp【转载请注明来源】【转载请注明来源】-sourcemaps简单的生成：

【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。【本文受版权保护】

var gulp = require('gulp');
var cleanCSS = require('gulp-clean-css');
var sourcemaps = require('gulp-sourcemaps');
gulp.task('minify-css', function() {
  return gulp.src('./src/*.css')
    .pipe(sourcemaps.init())
    .pipe(cleanCSS())
    .pipe(sourcemaps.write())
    .pipe(gulp.dest('dist'));
  });
});

图片压缩

压缩PNG、JPEG、GIF和SVG图像【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】。

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

gulp-imagemin集成了 gif本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。sicle 、 jpegtran 、 o转载请注明出处：www.tangshuang.net【作者：唐霜】ptipng 、 svgo 这4个插件。未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net而imagemin-pngquant是i【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。magemin插件的一个扩展插件，用于深著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。度压缩图片。

【本文受版权保护】【关注微信公众号：wwwtangshuangnet】

安装命令：

未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net

npm install gulp-imagemin imagemin-pngquant --save-dev

基础配置：

【本文受版权保护】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

var gulp = require('gulp'); // 基础库
var imagemin = require('gulp-imagemin'); // 图片压缩
var pngquant = require('imagemin-pngquant'); // 深度压缩
gulp.task('images', function(){
  return gulp.src('src/images/**/*.{png,jpg,gif,svg}') // 指明源文件路径、并进行文件匹配
    .pipe(imagemin({
      progressive: true, // 无损压缩JPG图片
      svgoPlugins: [{removeViewBox: false}], // 不移除svg的viewbox属性
      use: [pngquant()] // 使用pngquant插件进行深度压缩
    }))
    .pipe(gulp.dest('dist/images')); // 输出路径
});

执行命令：

gulp images

注：一般我们所使用的图片压缩方法，都会对著作权归作者所有，禁止商业用途转载。【本文受版权保护】图像造成一定的损失，这个和压缩比率有一定【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】的关系。通常我们所说的无损压缩，也只是控【版权所有，侵权必究】【本文受版权保护】制在我们肉眼难以发现的范围内。换句话来说【版权所有，侵权必究】【本文首发于唐霜的博客】，在你保存切图的同时，其实已经对图像造成转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。了一定的损失，因为没什么人会选择100%未经授权，禁止复制转载。【作者：唐霜】最佳质量导出图片。两者是差不多的概念。

【原创内容，转载请注明出处】【原创内容，转载请注明出处】原创内容，盗版必究。

服务器、自动刷新

【本文受版权保护】本文版权归作者所有，未经授权不得转载。

安装命令：

未经授权，禁止复制转载。【本文受版权保护】转载请注明出处：www.tangshuang.net原创内容，盗版必究。

npm install gulp-livereload gulp-webserver --save-dev

var gulp = require('gulp'); // 基础库
var livereload = require('gulp-livereload'); // 网页自动刷新（文件变动后即时刷新页面）
var webserver = require('gulp-webserver'); // 本地服务器
// 注册任务
gulp.task('webserver', function() {
  gulp.src( '.' ) // 服务器目录（.代表根目录）
    .pipe(webserver({ // 运行gulp-webserver
      livereload: true, // 启用LiveReload
      open: true // 服务器启动时自动打开网页
    }));
});
// 监听任务
gulp.task('watch',function(){
  // 监听 html
  gulp.watch('src/**/*.html', ['html'])
  // 监听 scss
  gulp.watch('src/scss/*.scss', ['css']);
  // 监听 images
  gulp.watch('src/images/**/*.{png,jpg,gif,svg}', ['images']);
  // 监听 js
  gulp.watch('src/js/*.js', ['script']);
});
// 默认任务
gulp.task('default',['webserver','watch']);

执行命令：

gulp

清除文件

gulp-clean

文档：https://www.npmjs.co【转载请注明来源】本文版权归作者所有，未经授权不得转载。m/package/gulp-clean
本文作者：唐霜，转载请注明出处。这个插件的作者已经放弃插件了。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】

del

$ npm install --save del

const del = require('del');
del(['tmp/*.js', '!tmp/unicorn.js']).then(paths => {
  console.log('Deleted files and folders:', paths.join(''));
});

但是有一点需要注意，它是异步的。

webpack

webpack的主要目的是为了压缩文件，【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。虽然gulp也有uglify，但是web未经授权，禁止复制转载。未经授权，禁止复制转载。pack的火热，让大家无论如何都想使用它著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】。

gulp-webpack

var gulp = require('gulp');
var webpack = require('gulp-webpack');
gulp.task('default', function() {
  return gulp.src('src/entry.js')
    .pipe(webpack())
    .pipe(gulp.dest('dist/'));
});

你可以给webpack传配置信息：

return gulp.src('src/entry.js')
  .pipe(webpack({
    watch: true,
    module: {
      loaders: [
        { test: /\.css$/, loader: 'style!css' },
      ],
    },
  }))
  .pipe(gulp.dest('dist/'));

上面有一个watch字段，这个是插件自带本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】的，不算webpack自带的。

转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【未经授权禁止转载】未经授权，禁止复制转载。

return gulp.src('src/entry.js')
  .pipe(webpack( require('./webpack.config.js') ))
  .pipe(gulp.dest('dist/'));

你甚至可以使用一个不同版本的webpac【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。k作为引擎：

npm install --save-dev webpack

var gulp = require('gulp');
var webpack = require('webpack');
var gulpWebpack = require('gulp-webpack');
gulp.task('default', function() {
  return gulp.src('src/entry.js')
    .pipe(gulpWebpack({}, webpack))
    .pipe(gulp.dest('dist/'));
});

插件还提供一个回调函数，用来使用webp本文版权归作者所有，未经授权不得转载。【转载请注明来源】ack的输出信息：

var gulp = require('gulp');
var webpack = require('gulp-webpack');
gulp.task('default', function() {
  return gulp.src('src/entry.js')
    .pipe(webpack({
      /* config */
    }, null, function(err, stats) {
      /* 用stats里面的信息可以做更多的操作 */
    }))
    .pipe(gulp.dest('dist/'));
});

当然，如果想要了解更多，还得去了解web【本文受版权保护】转载请注明出处：www.tangshuang.netpack本身，这里是官网。

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

karma

在gulp的体系里面使用karma进行单原创内容，盗版必究。【原创内容，转载请注明出处】元测试。

【本文受版权保护】本文作者：唐霜，转载请注明出处。

gulp已经拥有了karma需要的机制，原创内容，盗版必究。【原创不易，请尊重版权】就是注册任务的时候可以提供一个回调函数，【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】回调函数的参数是一个状态终结器。因此，不【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。需要额外安装karma插件来运行karm【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。a，直接使用karma就可以了。

【原创不易，请尊重版权】【作者：唐霜】转载请注明出处：www.tangshuang.net

var gulp = require('gulp');
var Server = require('karma').Server;
/** * Run test once and exit */
gulp.task('test', function (done) {
  new Server({
    configFile: __dirname + '/karma.conf.js',
    singleRun: true
  }, done).start();
});

原理也很简单，执行gulp test的时【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。候，调用karma进行测试，karma的【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。配置全部都放在karma.conf.js【本文受版权保护】著作权归作者所有，禁止商业用途转载。里面，实际上这个过程可以看做是一个触发过【转载请注明来源】原创内容，盗版必究。程，跟在命令行执行karma命令一样。

本文作者：唐霜，转载请注明出处。【转载请注明来源】

唯一比较有趣的是，可以直接给karma 转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netservice传done这个回调函数的参未经授权，禁止复制转载。【作者：唐霜】数（实际上也是个函数），一旦done()著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】被执行，那么test任务就结束了，我们所【作者：唐霜】【作者：唐霜】感知到的，就是命令行里面这个task结束本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。。

【未经授权禁止转载】原创内容，盗版必究。

要了解更多的测试的信息，你还得去学习ka原创内容，盗版必究。【作者：唐霜】rma，这里是官网。

而且前端的单元测试比较复杂，因为前端还要本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】涉及到浏览器等问题，希望你能够为这个问题【本文首发于唐霜的博客】【原创不易，请尊重版权】贡献内容。

插件开发

gulp插件总是返回一个object mode形式的stream来做这些事情：

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。

接收vinyl File对象

【转载请注明来源】

著作权归作者所有，禁止商业用途转载。

原创内容，盗版必究。

输出vinyl File对象

转载请注明出处：www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】

【本文首发于唐霜的博客】

未经授权，禁止复制转载。原创内容，盗版必究。原创内容，盗版必究。【原创内容，转载请注明出处】

修改文内容

未经授权，禁止复制转载。【转载请注明来源】【原创不易，请尊重版权】

Vinyl文件可以通过三种不同形式来访问原创内容，盗版必究。未经授权，禁止复制转载。文件内容：

【原创内容，转载请注明出处】【原创不易，请尊重版权】

Streams

【本文受版权保护】

转载请注明出处：www.tangshuang.net

未经授权，禁止复制转载。

Buffers

【作者：唐霜】

【本文受版权保护】

空 (null) – 对于删著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】除, 清理, 等操作来说，会很有用，因为【作者：唐霜】本文作者：唐霜，转载请注明出处。这时候内容是不需要处理的。

【关注微信公众号：wwwtangshuangnet】

未经授权，禁止复制转载。

转载请注明出处：www.tangshuang.net

有用的资源

【本文受版权保护】未经授权，禁止复制转载。原创内容，盗版必究。

File object

【原创内容，转载请注明出处】

未经授权，禁止复制转载。

PluginError

本文版权归作者所有，未经授权不得转载。

【作者：唐霜】

【转载请注明来源】

event-stream

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。

BufferStream

【原创内容，转载请注明出处】

【关注微信公众号：wwwtangshuangnet】

转载请注明出处：www.tangshuang.net

gulp-util

本文版权归作者所有，未经授权不得转载。

【转载请注明来源】

插件范例

【原创内容，转载请注明出处】【本文受版权保护】【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

sindresorhus’ 【本文受版权保护】【未经授权禁止转载】gulp plugins

【作者：唐霜】

Fractal’s gulp【作者：唐霜】本文作者：唐霜，转载请注明出处。 plugins

【作者：唐霜】

转载请注明出处：www.tangshuang.net

gulp-replace

本文作者：唐霜，转载请注明出处。

【访问 www.tangshuang.net 获取更多精彩内容】

关于 stream

如果你不熟悉 stream，你可以阅读这【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】些来

原创内容，盗版必究。

【作者：唐霜】

本文作者：唐霜，转载请注明出处。

未经授权，禁止复制转载。

http://nodejs.org/ap【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】i/stream.html

【作者：唐霜】

未经授权，禁止复制转载。

其他的一些为 gulp 创建的和使用的，著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】但又并非通过 stream 去处理的库，转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】在 npm 上都会被打上 gulpfri未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。endly 标签。

转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。

基本规范

你在开发一个gulp插件的时候，最好遵守【未经授权禁止转载】【本文受版权保护】下面的规范：

你的插件不应该去做一些现有 node 模【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】块已经能很容易做到的事情
【未经授权禁止转载】比如：删除一个文件夹并不需要做成一个本文作者：唐霜，转载请注明出处。【未经授权禁止转载】gulp 插件，在 task 里使用一个【本文受版权保护】【原创内容，转载请注明出处】类似 del 这样的插件即可。
【本文首发于唐霜的博客】只是为了封装而封装一些的东西进去，这只本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net会增加很多低质量的插件到生态中，这不符合本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】 gulp 的期望。
【本文受版权保护】 gulp 插件都是以文件为基础操作的，【本文受版权保护】未经授权，禁止复制转载。如果你发现你正在把一些很复杂的操作塞进【原创内容，转载请注明出处】【本文受版权保护】stream 中去，那么，请直接写一个【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。node 模块就好。
本文版权归作者所有，未经授权不得转载。一个好的 gulp 插件例子像是 gu【原创不易，请尊重版权】【本文受版权保护】lp-coffee，coffee-scr【本文受版权保护】【版权所有】唐霜 www.tangshuang.netipt 模块并不能直接和 vinyl 做原创内容，盗版必究。转载请注明出处：www.tangshuang.net很好的适配，因此，才去封装它来使用相应的原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。功能，并且将一些比较痛苦的操作抽象出来，【原创不易，请尊重版权】【原创不易，请尊重版权】做成更简单的 gulp 插件来使用。

转载请注明出处：www.tangshuang.net

【未经授权禁止转载】

未经授权，禁止复制转载。

本文版权归作者所有，未经授权不得转载。

著作权归作者所有，禁止商业用途转载。

【作者：唐霜】

你的插件不能去做一些其他插件做的事：
【关注微信公众号：wwwtangshuangnet】不应该去拼接，用 gulp-conca未经授权，禁止复制转载。【作者：唐霜】t 去做
原创内容，盗版必究。不应该去增加头部，用 gulp-hea【版权所有，侵权必究】【版权所有，侵权必究】der 去做
【关注微信公众号：wwwtangshuangnet】不应该去增加尾部，用 gulp-foo本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。ter 去做
未经授权，禁止复制转载。如果是一个常用的可选的操作，那么，请在【未经授权禁止转载】本文作者：唐霜，转载请注明出处。文档中注明你的插件通常和其他某个插件一起【本文受版权保护】【关注微信公众号：wwwtangshuangnet】使用
原创内容，盗版必究。在你的插件中使用其他的插件，这能大大减本文作者：唐霜，转载请注明出处。原创内容，盗版必究。少你的代码量，并保证生态系统的稳定。

本文版权归作者所有，未经授权不得转载。

转载请注明出处：www.tangshuang.net

你的插件必须被测试过
【未经授权禁止转载】测试一个插件很简单，你甚至不需要 gu【转载请注明来源】本文作者：唐霜，转载请注明出处。lp 就能测试
【原创内容，转载请注明出处】参考其他的插件是怎么做的

本文版权归作者所有，未经授权不得转载。

原创内容，盗版必究。

在 package.json 中增加一个【原创不易，请尊重版权】【原创不易，请尊重版权】名为 gulpplugin 的关键字，这转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。可以让它能在我们的搜索中出现

【转载请注明来源】

【原创不易，请尊重版权】

【本文受版权保护】

【未经授权禁止转载】

本文作者：唐霜，转载请注明出处。

转载请注明出处：www.tangshuang.net

错误需要加上以你插件名字作为前缀
【访问 www.tangshuang.net 获取更多精彩内容】比如： gulp-replace: C本文作者：唐霜，转载请注明出处。【本文受版权保护】annot do regexp repl【原创不易，请尊重版权】【原创不易，请尊重版权】ace on a stream
【未经授权禁止转载】使用 gulp-util 的 Plug【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】inError 类来完成它

【本文受版权保护】

【原创不易，请尊重版权】

file.contents 的类型需要总未经授权，禁止复制转载。【转载请注明来源】是在输入输出中保持一致
【未经授权禁止转载】如果 file.contents 为空【原创内容，转载请注明出处】未经授权，禁止复制转载。 (不可读) 请将他忽略，并传过去
【访问 www.tangshuang.net 获取更多精彩内容】如果 file.contents 是一【关注微信公众号：wwwtangshuangnet】【本文受版权保护】个 stream，但是你不支持，那么请触著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。发一个错误
【版权所有，侵权必究】不要把 stream 硬转成 buff【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】er 来使你的插件支持 stream，这本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】会引发很严重的问题。

【原创不易，请尊重版权】

原创内容，盗版必究。

在你处理完成之前，不要将 file 传到【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net下游去

【本文首发于唐霜的博客】

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。

【访问 www.tangshuang.net 获取更多精彩内容】

【关注微信公众号：wwwtangshuangnet】

著作权归作者所有，禁止商业用途转载。

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。

【本文受版权保护】

不要把 gulp 作为一个依赖
【本文首发于唐霜的博客】使用 gulp 来测试你的插件的工作流【本文首发于唐霜的博客】【原创内容，转载请注明出处】这的确很酷，但请务必确保你将它放到 de【本文受版权保护】转载请注明出处：www.tangshuang.netvDependency 中
转载请注明出处：www.tangshuang.net 在你的插件中依赖 gulp，这意味着安原创内容，盗版必究。【本文受版权保护】装你的插件的用户将会重新安装一遍 gul原创内容，盗版必究。本文作者：唐霜，转载请注明出处。p 以及所有它所依赖的东西。
【版权所有】唐霜 www.tangshuang.net 没有任何理由说明你需要将 gulp 写未经授权，禁止复制转载。原创内容，盗版必究。到你的插件代码中去，如果你发现你必须这么【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】做，那么请开一个 issue，我们会帮你本文作者：唐霜，转载请注明出处。【未经授权禁止转载】解决。

原创内容，盗版必究。

为什么这些指导这么严格？

gulp 的目标是为了让用户觉得简单，通【本文首发于唐霜的博客】【原创内容，转载请注明出处】过提供一些严格的指导，我们就能提供一致并未经授权，禁止复制转载。【作者：唐霜】且高质量的生态系统给大家。不过，这确实给【作者：唐霜】未经授权，禁止复制转载。插件作者增加了一些需要考虑的东西，但是也【转载请注明来源】【未经授权禁止转载】确保了后面的问题会更少。

【转载请注明来源】转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

如果我不遵守这些，会发生什么？

转载请注明出处：www.tangshuang.net【转载请注明来源】

npm 对每个人来说是免费的，你可以开发【本文首发于唐霜的博客】【转载请注明来源】任何你想要开发的东西出来，并且不需要遵守本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】这个规定。我们承诺测试机制将会很快建立起本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】来，并且加入我们的插件搜索中。如果你坚持【版权所有，侵权必究】【原创不易，请尊重版权】不遵守插件导览，那么这会反应在我们的打分【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。/排名系统上，人们都会更加喜欢去使用一个本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。 “更加 gulp̶著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】1; 的插件。

著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net

一个插件大概会是怎么样的？

【未经授权禁止转载】原创内容，盗版必究。【未经授权禁止转载】本文作者：唐霜，转载请注明出处。

// through2 是一个对 node 的 transform streams 简单封装
var through = require('through2');
var gutil = require('gulp-util');
var PluginError = gutil.PluginError;
// 常量
const PLUGIN_NAME = 'gulp-prefixer';
function prefixStream(prefixText) {
  var stream = through();
  stream.write(prefixText);
  return stream;
}
// 插件级别函数 (处理文件)
function gulpPrefixer(prefixText) {
  if (!prefixText) {
    throw new PluginError(PLUGIN_NAME, 'Missing prefix text!');
  }
  prefixText = new Buffer(prefixText); // 预先分配
  // 创建一个让每个文件通过的 stream 通道
  return through.obj(function(file, enc, cb) {
    if (file.isNull()) {
      // 返回空文件
      cb(null, file);
    }
    if (file.isBuffer()) {
      file.contents = Buffer.concat([prefixText, file.contents]);
    }
    if (file.isStream()) {
      file.contents = file.contents.pipe(prefixStream(prefixText));
    }
    cb(null, file);
  });
};
// 暴露（export）插件主函数
module.exports = gulpPrefixer;

以上就是本节的内容。

【原创内容，转载请注明出处】【作者：唐霜】

stream

极力推荐让你所写的插件支持 stream【转载请注明来源】【转载请注明来源】。这里有一些关于让插件支持 stream转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】的一些有用信息。
【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】
请确保使用处理错误的最佳实践，并且加入一【作者：唐霜】【版权所有】唐霜 www.tangshuang.net行代码，使得 gulp 能在转换内容的期转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】间在捕获到第一个错误时候正确报出错误。
本文作者：唐霜，转载请注明出处。【转载请注明来源】

【作者：唐霜】【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】

什么是stream

【原创内容，转载请注明出处】【本文首发于唐霜的博客】

那么什么是流式传输呢？就是一个文件不是一【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net次性传输，而是像流水一样，慢慢传，可以分【未经授权禁止转载】【作者：唐霜】成一段一段的，而这一段一段的东西，我们就本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。可以成为buffer，但是buffer不【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。是stream，buffer只是stre【转载请注明来源】转载请注明出处：www.tangshuang.netam附带了一种东西。

【原创内容，转载请注明出处】【本文首发于唐霜的博客】【作者：唐霜】【本文首发于唐霜的博客】

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。【转载请注明来源】

而在node的体系里，读取文件可以以st【关注微信公众号：wwwtangshuangnet】【作者：唐霜】ream的形式进行读取，读取过程中会产生转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】buffer。除了读，stream还可以【原创不易，请尊重版权】【本文受版权保护】被写入。但是stream不是文件本身，而【版权所有，侵权必究】未经授权，禁止复制转载。是文件的内容的某种形式，所以只要文件的内未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net容还是以stream的形式存在，那这个文原创内容，盗版必究。【本文首发于唐霜的博客】件相当于只有灵魂没有肉体。

转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

使用stream

让我们来实现一个用于在文件头部插入一些文【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net本的插件，这个插件支持 file.con【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。tents 所有可能的形式。

var through = require('through2');
var gutil = require('gulp-util');
var PluginError = gutil.PluginError;
// 常量const PLUGIN_NAME = 'gulp-prefixer';
function prefixStream(prefixText) {
  var stream = through();
  stream.write(prefixText);
  return stream;
}
// 插件级别函数 (处理文件)
function gulpPrefixer(prefixText) {
  if (!prefixText) {
    throw new PluginError(PLUGIN_NAME, 'Missing prefix text!');
  }
  prefixText = new Buffer(prefixText); // 预先分配
  // 创建一个让每个文件通过的 stream 通道
  var stream = through.obj(function(file, enc, cb) {
    if (file.isBuffer()) {
      this.emit('error', new PluginError(PLUGIN_NAME, 'Buffers not supported!'));
      return cb();
    }
    if (file.isStream()) {
      // 定义转换内容的 streamer
      var streamer = prefixStream(prefixText);
      // 从 streamer 中捕获错误，并发出一个 gulp的错误
      streamer.on('error', this.emit.bind(this, 'error'));
      // 开始转换
      file.contents = file.contents.pipe(streamer);
    }
    // 确保文件进去下一个插件
    this.push(file);
    // 告诉 stream 转换工作完成
    cb();
  });
  // 返回文件 stream
  return stream;
}
// 暴露（export）插件的主函数
module.exports = gulpPrefixer;

上面的插件可以像这样使用：

var gulp = require('gulp');
var gulpPrefixer = require('gulp-prefixer');
gulp.src('files/**/*.js', { buffer: false })
  .pipe(gulpPrefixer('prepended string'))
  .pipe(gulp.dest('modified-files'));

一些使用 stream 的插件

转载请注明出处：www.tangshuang.net

本文作者：唐霜，转载请注明出处。

【原创内容，转载请注明出处】

未经授权，禁止复制转载。

buffer

什么是buffer

在stream那一节已经提到了buffe原创内容，盗版必究。【作者：唐霜】r，但是并不能全面的表达buffer的概【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net念。从我个人的理解角度讲，buffer的【版权所有】唐霜 www.tangshuang.net【作者：唐霜】本质就是一个缓存区，这个缓存区用于交换数【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。据。它不一定在stream中才使用，但是【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。是使用最常见的。

大一个比方，有1000000000000【本文受版权保护】著作权归作者所有，禁止商业用途转载。00吨水要从海洋运往沙漠，现在这个运输的【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。过程中所有的水就是stream，水从大海【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。流向了沙漠，但是是怎么流的呢？可不是直接本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】整个砸进沙漠里，而是靠人们发明的一种神秘原创内容，盗版必究。未经授权，禁止复制转载。盒子进行运输，这个盒子在大海和沙漠之间以【本文首发于唐霜的博客】【本文首发于唐霜的博客】光速来回运动，把大海里的水按照每次200转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。吨进行运输，但是由于一些情况，人们把盒子【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。的容量调整到了1000吨，这个盒子就是b【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】uffer。
【本文首发于唐霜的博客】在读取一个大文件的时候，node不会一【原创内容，转载请注明出处】【作者：唐霜】次性把所有的文件内容都读取到内存中，而是【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。一点一点的读，读完的部分写入另外一个文件本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】，这个过程就是stream的运动过程，那本文版权归作者所有，未经授权不得转载。【作者：唐霜】么这个“一点一点”的东西在哪里呢？就在b本文作者：唐霜，转载请注明出处。原创内容，盗版必究。uffer里，每次读一点，就放到buff【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.neter里，你可以对这个buffer进行改写【未经授权禁止转载】【原创不易，请尊重版权】，这样最终的文件跟原始文件就有非常大的区【未经授权禁止转载】转载请注明出处：www.tangshuang.net别。

本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】

使用buffer

如果你的插件依赖着一个基于 buffer【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】处理的库，你可能会选择让你的插件以 b原创内容，盗版必究。【版权所有，侵权必究】uffer 的形式来处理 file.co【本文首发于唐霜的博客】【本文首发于唐霜的博客】ntents。让我们来实现一个在文件头部转载请注明出处：www.tangshuang.net【转载请注明来源】插入额外文本的插件：

var through = require('through2');
var gutil = require('gulp-util');
var PluginError = gutil.PluginError;
// 常量
const PLUGIN_NAME = 'gulp-prefixer';
// 插件级别的函数（处理文件）
function gulpPrefixer(prefixText) {
  if (!prefixText) {
    throw new PluginError(PLUGIN_NAME, 'Missing prefix text!');
  }
  prefixText = new Buffer(prefixText); // 提前分配
  // 创建一个 stream 通道，以让每个文件通过
  var stream = through.obj(function(file, enc, cb) {
    if (file.isStream()) {
      this.emit('error', new PluginError(PLUGIN_NAME, 'Streams are not supported!'));
      return cb();
    }
    if (file.isBuffer()) {
      file.contents = Buffer.concat([prefixText, file.contents]);
    }
    // 确保文件进入下一个 gulp 插件
    this.push(file);
    // 告诉 stream 引擎，我们已经处理完了这个文件
    cb();
  });
  // 返回文件 stream
  return stream;
};
// 导出插件主函数
module.exports = gulpPrefixer;

上述的插件可以这样使用：

原创内容，盗版必究。【本文首发于唐霜的博客】

var gulp = require('gulp');
var gulpPrefixer = require('gulp-prefixer');
gulp.src('files/**/*.js')
  .pipe(gulpPrefixer('prepended string'))
  .pipe(gulp.dest('modified-files'));

处理 stream

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

不幸的是，当 gulp.src 如果是以著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。 stream 的形式，而不是 buff原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。er，那么，上面的插件就会报错。如果可以【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。，你也应该让他支持 stream 形式。本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。请查看使用 Stream 处理获取更多【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net信息。

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。原创内容，盗版必究。

一些基于 buffer 的插件

gulp-coffee

【原创不易，请尊重版权】

未经授权，禁止复制转载。

gulp-svgmin

转载请注明出处：www.tangshuang.net

gulp-marked

【原创内容，转载请注明出处】

未经授权，禁止复制转载。

gulp-svg2ttf

【本文受版权保护】

【原创不易，请尊重版权】

测试

var assert = require('assert');
var es = require('event-stream');
var File = require('vinyl');
var prefixer = require('../');
describe('gulp-prefixer', function() {
  describe('in streaming mode', function() {
    it('should prepend text', function(done) {
      // 创建伪文件
      var fakeFile = new File({
        contents: es.readArray(['stream', 'with', 'those', 'contents'])
      });
      // 创建一个 prefixer 流（stream）
      var myPrefixer = prefixer('prependthis');
      // 将伪文件写入
      myPrefixer.write(fakeFile);
      // 等文件重新出来
      myPrefixer.once('data', function(file) {
        // 确保它以相同的方式出来
        assert(file.isStream());
        // 缓存内容来确保它已经被处理过（加前缀内容）
        file.contents.pipe(es.wait(function(err, data) {
          // 检查内容
          assert.equal(data, 'prependthisstreamwiththosecontents');
          done();
        }));
      });
    });
  });
});

测试插件的 buffer 模式

var assert = require('assert');
var es = require('event-stream');
var File = require('vinyl');
var prefixer = require('../');
describe('gulp-prefixer', function() {
  describe('in buffer mode', function() {
    it('should prepend text', function(done) {
      // 创建伪文件
      var fakeFile = new File({
        contents: new Buffer('abufferwiththiscontent')
      });
      // 创建一个 prefixer 流（stream）
      var myPrefixer = prefixer('prependthis');
      // 将伪文件写入
      myPrefixer.write(fakeFile);
      // 等文件重新出来
      myPrefixer.once('data', function(file) {
        // 确保它以相同的方式出来
        assert(file.isBuffer());
        // 检查内容
        assert.equal(file.contents.toString('utf8'), 'prependthisabufferwiththiscontent');
        done();
      });
    });
  });
});

一些拥有高质量的测试用例的插件

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。

gulp-cat

转载请注明出处：www.tangshuang.net

【本文受版权保护】

未经授权，禁止复制转载。

gulp-concat

【转载请注明来源】

【本文首发于唐霜的博客】

转载请注明出处：www.tangshuang.net

资源

官网：http://gulpjs.com/

【原创不易，请尊重版权】

原创内容，盗版必究。

【访问 www.tangshuang.net 获取更多精彩内容】

转载请注明出处：www.tangshuang.net

github: https://github.com/g【本文受版权保护】转载请注明出处：www.tangshuang.netulpjs/gulp

【转载请注明来源】

本文作者：唐霜，转载请注明出处。

中文网站：http://www.gulpjs.co【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。m.cn/

【转载请注明来源】

本文版权归作者所有，未经授权不得转载。

本文作者：唐霜，转载请注明出处。

stackoverfollow：http://stackoverflow【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。.com/questions/tagge原创内容，盗版必究。【未经授权禁止转载】d/gulp

本文版权归作者所有，未经授权不得转载。

【作者：唐霜】

一些使用技巧

【原创不易，请尊重版权】

原创内容，盗版必究。

未经授权，禁止复制转载。

node api

【作者：唐霜】

【本文首发于唐霜的博客】【版权所有，侵权必究】【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【本文受版权保护】【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】原创内容，盗版必究。【作者：唐霜】【本文首发于唐霜的博客】【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】

如果你觉得本书对你有帮助，通过下方的二维码向我打赏吧，帮助我写出更多有用的内容。

2017-02-03 | gulp