Gulp入门

引言

gulp 是基于 Nodejs 的自动任务运行器，能自动化地完成javascript/coffee/sass/less/html/image/css等文件的的测试、检查、合并、压缩、格式化、浏览器自动刷新、部署文件生成，并监听文件在改动后重复指定的这些步骤。在实现上，gulp 借鉴了Unix操作系统的管道（pipe）思想，前一级的输出，直接变成后一级的输入，使得在操作上非常简单.

一、安装Gulp

gulp 是基于 Nodejs 的自动任务运行器，所以安装gulp之前要先安装node.js环境。

打开Nodejs官网，点击硕大的绿色“install”按钮，可以检测一下安装的Node和npm版本：

然后全局安装gulp：

npm install -g gulp

同样安装完之后，可以检测gulp的版本：

全局安装gulp后，还需要在每个要使用gulp的项目中都单独安装一次。把目录切换到你的项目文件夹中，然后在命令行中执行：

 npm install gulp

如果想在安装的时候把gulp写进项目package.json文件的依赖中，则可以加上–save-dev：

 npm install gulp --save-dev

--save：将保存配置信息至package.json（package.json是nodejs项目配置文件。package.json是一个普通json文件，不能添加任何注释。参看 http://www.zhihu.com/question/23004511
）；
-dev/-dep：保存至package.json的devDependencies节点，不指定-dev/dep将保存至dependencies节点；

安装Gulp之后，可以运行npm init初始化package.json文件：

需要注意的是，name是不能包含大写字母的:

初始化之后，需要在项目的根目录下建立gulpfile.js文件，文件名不能更改：

var gulp = require('gulp');

gulp.task('default', function() {

console.log('hello gulp');

});

默认任务将被运行，向控制台输出hello gulp。如果需要运行单个任务, 使用 gulp taskname命令(上述等效于gulp default)。

也可以看gulp官方的 Getting Started

二、Gulp API

gulp在git上只介绍了四个API：task、dest、src、watch，除此之外，gulp还提供了一个run方法。

1.gulp.src(globs[, options])
src()方法是指定需要处理的源文件的路径，gulp借鉴了Unix操作系统的管道（pipe）思想，前一级的输出，直接变成后一级的输入，gulp.src返回当前文件流至可用插件.

globs的文件匹配说明：
“src/a.js”：指定具体文件；
“*”：匹配所有文件 例：src/*.js(包含src下的所有js文件)；
“**”：匹配0个或多个子文件夹 例：src/**/*.js(包含src的0个或多个子文件夹下的js文件)；
“{}”：匹配多个属性 例：src/{a,b}.js(包含a.js和b.js文件) src/*.{jpg,png,gif}(src下的所有jpg/png/gif文件)；
“!”：排除文件 例：!src/a.js(不包含src下的a.js文件)；

var gulp = require('gulp'),
gulp.task('test', function () {
//gulp.src('test/style.css')
gulp.src(['css/**/*.css','!css/{extend,page}/*.css'])
.pipe(gulp.dest('./css'));
});

options的三个属性说明：
options.buffer： 类型：Boolean 默认：true 设置为false，将返回file.content的流并且不缓冲文件，处理大文件时非常有用；
options.read： 类型：Boolean 默认：true 设置false，将不执行读取文件操作，返回null；
options.base： 类型：String 设置输出路径以某个路径的某个组成部分为基础向后拼接

2.gulp.dest(path[, options])
dest()方法是指定处理完后文件输出的路径；

options.cwd
Type: String Default: process.cwd()
cwd for the output folder, only has an effect if provided output folder is relative.
options.mode
Type: String Default: 0777
Octal permission string specifying mode for any folders that need to be created for output folder.

修改之前的gulpfile.js的内容如下：

 
var gulp = require('gulp');
gulp.task('testtask', function() {
gulp.src('./js/test.js')
.pipe(gulp.dest('./build'));
});

运行结果如下图：

利用gulp.dest('./build')将新建的test.js文件移动到了build目录，对比前后两次的ls -al命令，dest()会自动创建目录。

3.gulp.task(name[, deps], fn)
该方法用于定义一个gulp任务。

再次修改gulpfile.js文件，定义一个任务列表

 
var gulp = require('gulp');
gulp.task('task1',function(){
console.log('task1 done');
});
gulp.task('task2',function(){
console.log('task2 done!');
});
gulp.task('task3',function(){
console.log('task3 done');
});
gulp.task('end',['task1','task3','task2'],function(){
console.log('end done');
});

运行结果：

4.gulp.watch(glob [, opts], tasks) or gulp.watch(glob [, opts, cb])
watch()方法是用于监听文件变化，文件一修改就会执行指定的任务.

每当监视的文件发生变化时，就会调用cb函数,并且会给它传入一个对象，该对象包含了文件变化的一些信息:
type:属性为变化的类型，可以是added,changed,deleted
path:属性为发生变化的文件的路径

gulp.task('uglify',function(){
//do something
});
gulp.task('reload',function(){
//do something
});
gulp.watch('js/**/*.js', ['uglify','reload']);
watcher.on('change', function(event) {
console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
});
// same as
gulp.watch('js/**/*.js', function(event){
//变化类型 added为新增,deleted为删除，changed为改变
console.log(event.type);
//变化的文件的路径
console.log(event.path);
});

5.gulp.run()
gulp模块的run()方法，表示要执行的任务。可能会使用单个参数的形式传递多个任务。注意：任务是尽可能多的并行执行的，并且可能不会按照指定的顺序运行.

修改之前的gulpfile.js文件中的end任务：

gulp.task('end',function(){
gulp.run('task1','task3','task2');
});

运行结果：

三、gulp常见插件

1.gulp-uglify
使用gulp-uglify压缩javascript文件，减小文件大小。

利用npm先安装gulp-uglify:

npm install --save-dev gulp-uglify

安装之后，在gulpfile.js中引入：

var gulp = require('gulp'),

uglify = require("gulp-uglify");

gulp.task('minify-js', function () {

gulp.src('js/*.js') // 要压缩的js文件

.pipe(uglify())

.pipe(gulp.dest('dist/js')); //压缩后的路径

});

###压缩多个文件
var gulp = require('gulp'),
uglify = require('gulp-uglify');
gulp.task('jsmin', function () {
//多个文件以数组形式传入
gulp.src(['src/js/index.js','src/js/detail.js'])
.pipe(uglify())
.pipe(gulp.dest('dist/js'));
});
var gulp = require('gulp'),
uglify= require('gulp-uglify');
##匹配符“!”，“*”，“**”，“{}”
gulp.task('jsmin', function () {
//压缩src/js目录下的所有js文件
//除了test1.js和test2.js（**匹配src/js的0个或多个子文件夹）
gulp.src(['src/js/*.js', '!src/js/**/{test1,test2}.js'])
.pipe(uglify())
.pipe(gulp.dest('dist/js'));
});

2.gulp-rename
用来重命名文件流中的文件。用gulp.dest()方法写入文件时，文件名使用的是文件流中的文件名，如果要想改变文件名，那可以在之前用gulp-rename插件来改变文件流中的文件名。

 
npm install --save-dev gulp-rename

简单运用：

var gulp = require('gulp'),
rename = require('gulp-rename'),
uglify = require("gulp-uglify");
gulp.task('rename', function () {
gulp.src('js/jquery.js')
.pipe(uglify()) //压缩
//会将jquery.js重命名为jquery.min.js
.pipe(rename('jquery.min.js'))
.pipe(gulp.dest('js'));
});

3.gulp-minify-css
压缩css文件时并给引用url添加版本号避免缓存:

npm install --save-dev gulp-minify-css

简单运用：

var gulp = require('gulp'),

cssmin = require('gulp-minify-css');

//确保已本地安装gulp-make-css-url-version [npm install gulp-make-css-url-version --save-dev]

cssver = require('gulp-make-css-url-version');

gulp.task('testCssmin', function () {

gulp.src('src/css/*.css')

.pipe(cssver()) //给css文件里引用文件加版本号（文件MD5）

.pipe(cssmin())

.pipe(gulp.dest('dist/css'));

});

4.gulp-htmlmin
使用gulp-htmlmin压缩html，可以压缩页面javascript、css，去除页面空格、注释，删除多余属性等操作。

 
npm install --save-dev gulp-htmlmin

简单使用：

var gulp = require('gulp'),
htmlmin = require('gulp-htmlmin');
gulp.task('testHtmlmin', function () {
var options = {
removeComments: true,//清除HTML注释
collapseWhitespace: true,//压缩HTML
//省略布尔属性的值 <input checked="true"/> ==> <input />
collapseBooleanAttributes: true,
//删除所有空格作属性值 <input id="" /> ==> <input />
removeEmptyAttributes: true,
//删除<script>的type="text/javascript"
removeScriptTypeAttributes: true,
//删除<style>和<link>的type="text/css"
removeStyleLinkTypeAttributes: true,
minifyJS: true,//压缩页面JS
minifyCSS: true//压缩页面CSS
};
gulp.src('src/html/*.html')
.pipe(htmlmin(options))
.pipe(gulp.dest('dist/html'));
});

5.gulp-concat
用来把多个文件合并为一个文件,我们可以用它来合并js或css文件等，这样就能减少页面的http请求数了.

npm install --save-dev gulp-concat

简单使用：

 
var gulp = require('gulp'),
concat = require("gulp-concat");
gulp.task('concat', function () {
gulp.src('js/*.js') //要合并的文件
.pipe(concat('all.js')) // 合并匹配到的js文件并命名为 "all.js"
.pipe(gulp.dest('dist/js'));
});
其它常用插件：

gulp-imagemin:压缩图片文件
gulp-jshint:侦测javascript代码中错误和潜在问题的工具