gulp（一）

简介：

gulp是前端开发过程中对代码进行构建的工具，是自动化项目的构建利器；她不仅能对网站资源进行优化，而且在开发过程中很多重复的任务能够使用正确的工具自动完成；使用她，我们不仅可以很愉快的编写代码，而且大大提高我们的工作效率。

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

ok开始说一些学习步骤：

安装nodejs -> 全局安装gulp -> 项目安装gulp以及gulp插件 -> 配置gulpfile.js -> 运行任务

1、

说明：gulp是基于nodejs，理所当然需要安装nodejs；

安装：打开nodejs官网，点击硕大的绿色Download按钮，它会根据系统信息选择对应版本（.msi文件）。然后像安装QQ一样安装它就可以了（安装路径随意）。

2、

简单介绍gulp在使用过程中常用命令，打开命令提示符执行下列命令（打开方式：window + r 输入cmd回车）：

node -v查看安装的nodejs版本，出现版本号，说明刚刚已正确安装nodejs。PS：未能出现版本号，请尝试注销电脑重试；

npm -v查看npm的版本号，npm是在安装nodejs时一同安装的nodejs包管理器，那它有什么用呢？

cd定位到目录，用法：cd + 路径 ；

dir列出文件列表；

cls清空命令提示符窗口内容。

 

3、npm介绍

说明：npm（node package manager）nodejs的包管理器，用于node插件管理（包括安装、卸载、管理依赖等）；

使用npm安装插件：命令提示符执行npm install <name> [-g] [--save-dev]；

　　a、<name>：node插件名称。例：npm install gulp-less --save-dev

　　b、  -g：全局安装。将会安装在C:UsersAdministratorAppDataRoaming pm，并且写入系统环境变量；  非全局安装：将会安装在当前定位目录；  全局安装可以通过命令行在任何地方调用它，本地安装将安装在定位目录的node_modules文件夹下，通过require()调用；

　　c、--save：将保存配置信息至package.json（package.json是nodejs项目配置文件）；

　　d、-dev：保存至package.json的devDependencies节点，不指定-dev将保存至dependencies节点；一般保存在dependencies的像这些express/ejs/body-parser等等。

　　e、为什么要保存至package.json？因为node插件包相对来说非常庞大，所以不加入版本管理，将配置信息写入package.json并将其加入版本管理，其他开发者对应下载即可（命令提示符执行npm install，则会根据package.json下载所有需要的包，npm install --production只下载dependencies节点的包）。

　　f、使用npm卸载插件：npm uninstall <name> [-g] [--save-dev]  PS：不要直接删除本地插件包

　　g、删除全部插件：npm uninstall gulp-less gulp-uglify gulp-concat ……???太麻烦

　　h、借助rimraf：npm install rimraf -g 用法：rimraf node_modules

　　i、使用npm更新插件：npm update <name> [-g] [--save-dev]

　　j、更新全部插件：npm update [--save-dev]

　　k、查看npm帮助：npm help

　　l、当前目录已安装插件：npm list

4、cnmp

npm安装插件过程：从http://registry.npmjs.org下载对应的插件包（该网站服务器位于国外，所以经常下载缓慢或出现异常），淘宝团队为我们解决了这个问题，

http://npm.taobao.org这是一个完整 npmjs.org 镜像，可以用此代替官方版本(只读)，同步频率目前为 10分钟 一次以保证尽量与官方服务同步。

安装：命令提示符执行npm install cnpm -g --registry=https://registry.npm.taobao.org；  注意：安装完后最好查看其版本号cnpm -v或关闭命令提示符重新打开，安装完直接使用有可能会出现错误；

注：cnpm跟npm用法完全一致，只是在执行命令时将npm改为cnpm（以下操作将以cnpm代替npm）。

 

5、全局安装gulp

　　a、说明：全局安装gulp目的是为了通过她执行gulp任务；

　　b、安装：命令提示符执行cnpm install gulp -g；

　　c、查看是否正确安装：命令提示符执行gulp -v，出现版本号即为正确安装。

 

6、新建package.json文件

　　a、说明：package.json是基于nodejs项目必不可少的配置文件，它是存放在项目根目录的普通json文件；

　　b、它是这样一个json文件（注意：json文件内是不能写注释的，复制下列内容请删除注释）：

{
  "name": "test",   //项目名称（必须）
  "version": "1.0.0",   //项目版本（必须）
  "description": "This is for study gulp project !",   //项目描述（必须）
  "homepage": "",   //项目主页
  "repository": {    //项目资源库
    "type": "git",
    "url": "https://git.oschina.net/xxxx"
  },
  "author": {    //项目作者信息
    "name": "surging",
    "email": "surging2@qq.com"
  },
  "license": "ISC",    //项目许可协议
  "devDependencies": {    //项目依赖的插件
    "gulp": "^3.8.11",
    "gulp-less": "^3.0.0"
  }
}

当然我们可以手动新建这个配置文件，但是作为一名有志青年，我们应该使用更为效率的方法：命令提示符执行cnpm init

查看package.json帮助文档，命令提示符执行cnpm help package.json

接下来直接来点干的

操作之前先了解下面这几个单词或者说是方法

gulp.task(name, fn) 建立任务
gulp.run(tasks...) 尽可能多的并行运行多个task
gulp.watch(glob, fn) 当glob内容发生改变时，执行fn
gulp.src(glob) 返回一个可读的stream
gulp.dest(glob) 返回一个可写的stream
pipe(管道符) 管道操作

项目开始，先建一个目录resume

然后之前提到的方法在地址栏双击输入cmd进入命令行安装一系列插件

首先就是安装淘宝镜像：npm install -g cnpm --registry=https://registry.npm.taobao.org

接着依次安装运行以下命令
cnpm install gulp --save-dev
cnpm install gulp-htmlmin --save-dev
cnpm install gulp-imagemin --save-dev
cnpm install gulp-minify-css --save-dev
cnpm install gulp-rename --save-dev
cnpm install gulp-rev --save-dev
cnpm install gulp-rev-collector --save-dev
cnpm install gulp-sass --save-dev
cnpm install gulp-uglify --save-dev
cnpm install gulp-watch --save-dev
cnpm install gulp-watch-sequence --save-dev
cnpm install gulp-webserver --save-dev

安装完以后文件夹里面就会多出一些文件如下图：

接下来就是新建gulpfile.js文件了，找了以下网上的简单介绍：

说明：gulpfile.js是gulp项目的配置文件，是位于项目根目录的普通js文件（其实将gulpfile.js放入其他文件夹下亦可）。

它大概是这样一个js文件：

//导入工具包 require('node_modules里对应模块')
var gulp = require('gulp'), //本地安装gulp所用到的地方
    less = require('gulp-less');
 
//定义一个testLess任务（自定义任务名称）
gulp.task('testLess', function () {
    gulp.src('src/less/index.less') //该任务针对的文件
        .pipe(less()) //该任务调用的模块
        .pipe(gulp.dest('src/css')); //将会在src/css下生成index.css
});
 
gulp.task('default',['testLess', 'elseTask']); //定义默认任务 elseTask为其他任务，该示例没有定义elseTask任务
 
//gulp.task(name[, deps], fn) 定义任务  name：任务名称 deps：依赖任务名称 fn：回调函数
//gulp.src(globs[, options]) 执行任务处理的文件  globs：处理的文件路径(字符串或者字符串数组) 
//gulp.dest(path[, options]) 处理完后文件生成路径

然后是自己新建的gulpfile.js文件：

// 基础gulp模块
var gulp = require('gulp');
// webserver服务器模块
var webserver = require('gulp-webserver');

//mock数据操作,需要引入url及fs，但是url/fs是内置的，所以不需要安装
var url = require('url');
var fs = require('fs'); // fs -> filesystem

// sass转化
var sass = require('gulp-sass');

//js的模块化打包操作
var webpack = require('gulp-webpack');

//命名模块
var named = require('vinyl-named');
// cnpm install vinyl-named --save-dev

var uglify = require('gulp-uglify');

var minifyCss = require('gulp-minify-css');
// cnpm install gulp-minify-css --save-dev

//版本管理 
var rev = require('gulp-rev');
//版本控制
var revCollector = require('gulp-rev-collector');
//监控
var watch = require('gulp-watch');
//队列模块
var sequence = require('gulp-watch-sequence');

/*
1.创建src(src是开发目录，所有操作都在src中进行)目录
2.在src新建index.html(因为我们现在做的是spa项目，所以，通过只有一个入口主文件)
3.实现index.html的文件复制操作，复制的目标是www
4.webserver的本地服务器配置(不是gulp-connect)
5.实现mock数据操作，先在根目录下创建mock目录，然后在目录里放置对应的json文件
    mock文件有skill.json/project.json/work.json，对应的接口地址配置为/api/skill,/api/project,/api/work
6.实现sass转换
7.实现js的模块化开发操作
*/

gulp.task('copy-index',function(){
    return gulp.src('./src/index.html')
    .pipe(gulp.dest('./www'));
});

//创建本地服务器任务
gulp.task('webserver', function() {
  gulp.src('./www')
    .pipe(webserver({
      livereload: true,
      //directoryListing:true,
      open:true,
      port:1234,

      middleware:function(req,res,next){
          //获取浏览器中的url，将url进行解析操作
          var urlObj = url.parse(req.url,true),
          method = req.method;

          //如果url里输出了/skill.php,/project.php或者是/work，
          //那么我们就可以查找到urlObj.pathname为/skill.php,/project.php,/work
          //然后我们就可以通过这个变化的url地址内容去判断并且返回相应的
          //skill.json/project.json/work.json等数据文件的内容
          switch(urlObj.pathname){
              case '/skill':
                  // Content-Type可以指定返回的文件的格式类型
                  res.setHeader('Content-Type','application/json');
                  //需要通过fileSystem文件操作函数，去读取指定目录下的json文件，并将读取到的内容返回到浏览器端
                  fs.readFile('./mock/skill.json','utf-8',function(err,data){
                      res.end(data);
                  });

              return;

              case '/project':
                  res.setHeader('Content-Type','application/json');
                  fs.readFile('./mock/project.json','utf-8',function(err,data){
                      res.end(data);
                  });
              return;

              case '/work':
                  res.setHeader('Content-Type','application/json');
                  fs.readFile('./mock/work.json','utf-8',function(err,data){
                      res.end(data);
                  });
              return;
          }
      
          next(); // next是实现的循环
      } // end middleware

    })); // end gulp
});

// index.css/main.scss--->www/css/index.css
// 通常我们主有一个入口的主文件index.scss/index.css
// @import 'xxx'

gulp.task('sass',function(){
    return gulp.src('./src/styles/index.scss')
    .pipe(sass())
    .pipe(minifyCss()) //css 压缩
    .pipe(gulp.dest('./www/css'));
})


gulp.task('packjs',function(){
    return gulp.src('./src/scripts/index.js')
    .pipe(named())
    .pipe(webpack())
    .pipe(uglify()) // js丑化压缩
    .pipe(gulp.dest('./www/js'));
})


//版本管理操作

var cssDistFiles = ['./www/css/index.css'];
var jsDistFiles = ['./www/js/index.js'];

gulp.task('verCss',function(){
    //找到要进行版本控制操作的目标文件
    return gulp.src(cssDistFiles)
    //生成相应的版本
    .pipe(rev())
    //复制到指定的目录
    .pipe(gulp.dest('./www/css'))
    //生成相应的映射文件
    .pipe(rev.manifest())
    //将映射文件复制到指定的目录
    .pipe(gulp.dest('./www/ver/css'))
})


gulp.task('verJs',function(){
    //找到要进行版本控制操作的目标文件
    return gulp.src(jsDistFiles)
    //生成相应的版本
    .pipe(rev())
    //复制到指定的目录
    .pipe(gulp.dest('./www/js'))
    //生成相应的映射文件
    .pipe(rev.manifest())
    //将映射文件复制到指定的目录
    .pipe(gulp.dest('./www/ver/js'))
})

//文件的字符串替换操作
gulp.task('html',function(){
    //src第一个参数是我们的映射资源文件，第二个参数是我们需要替换的html文件
    gulp.src(['./www/ver/**/*.json','./www/*.html'])
    //进行字符串替换操作
    .pipe(revCollector({
        replaceReved:true
    }))
    //复制文件到指定目录
    .pipe(gulp.dest('./www'))
})


//监听操作
gulp.task('watch',function(){
    gulp.watch('./src/index.html',['copy-index']);

    //设置队列
    var queue = sequence(300);
    watch('./src/scripts/**',{
        name:"JS",
        emitOnGlob:false
    }, queue.getHandler('packjs','verJs','html'));

    watch('./src/styles/**',{
        name:"CSS",
        emitOnGlob:false
    }, queue.getHandler('sass','verCss','html'));

});

gulp.task('default',['webserver','watch'])

直接新建一个文件把上面的内容写进去就ok了，就是这样：

接下来就是新建一个src目录在里面做一些基本的文件配置：

上面是javascript里面放的，接下来就是样式里面创建的：

详细操作这里有视屏：js_data第三阶段视屏day10(视屏里这一块的内容靠后)

类库所在地址js_data第三阶段课件day07(iscroll类库和swiper类库)

准备工作差不多了，全部安装完成以后就运行gulp试试，可能会遇到以下问题：

还可能遇到下面的错误：

接下来就是最大的问题了：

解决办法：

还有一个小问题忘了，实在不行就ctr+c终端命令重启试试

这里就主要说一些问题，具体的东西视屏里面有，就不浪费时间了。

打开package.json就会看到如下代码(上面对package.json有介绍)：

{
  "name": "test",   //项目名称（必须）
  "version": "1.0.0",   //项目版本（必须）
  "description": "This is for study gulp project !",   //项目描述（必须）
  "homepage": "",   //项目主页
  "repository": {    //项目资源库
    "type": "git",
    "url": "https://git.oschina.net/xxxx"
  },
  "author": {    //项目作者信息
    "name": "surging",
    "email": "surging2@qq.com"
  },
  "license": "ISC",    //项目许可协议
  "devDependencies": {    //项目依赖的插件
    "gulp": "^3.8.11",
    "gulp-less": "^3.0.0"
  }
}

接下来在gulpBase文件夹中打开cmd命令行，并敲入命令npm init:

输入完文件名以后就一路敲回车(会出现一长串很长的代码)：

补充：

1、*.scss ：*号匹配当前目录任意文件，所以这里的＊scss匹配当前目录下所有scss文件。

2、**/*.scss:匹配当前目录及其子目录的所有scss文件。

3、！not-me.scss：！号移除匹配的文件，这里将移除not-me.scss

4、*.+(scss|sass):+号后面会跟着圆括号，里面的元素用｜分割，匹配多个选项，这里将匹配scss和sass文件。