![gulp 详解与使用](https://bu.dusays.com/2024/05/05/66365fd49d7f5.jpg)
gulp 详解与使用
什么是 gulp
gulp 是一个前端构建工具,它能通过自动执行常见任务,比如编译预处理 CSS ,压缩 JavaScript 和刷新浏览器,来改进网站开发的过程,从而使开发更加快速高效。
为什么要用 gulp
与 grunt 相比,gulp 无需写一大堆繁杂的配置参数,API(中文 API) 也非常简单,学习起来很容易,而且 gulp 使用的是 nodejs 中 stream 来读取和操作数据,其速度更快。
gulp 有庞大的生态圈,且每天都在发展。依靠成千上万可供选择的插件,你可以利用 gulp 自动完成几乎任何事。
如何使用 gulp
Installing Gulp
新版的 gulp 命令行工具已经改名为 gulp-cli 。
如果你之前安装了全局的 gulp 。在使用新的 gulp-cli 之前,执行命令npm rm --global gulp
,将之前的全局 gulp 卸掉。
Install the gulp command
1 | npm install --global gulp-cli |
Install gulp in your devDependencies
Run this command in your project directory
1 | npm install --save-dev gulp |
Create a gulpfile
Create a file called gulpfile.js in your project root with these contents:
1 | var gulp = require('gulp'); |
Test it out
Run the gulp command in your projct directory:
1 | gulp |
gulp API
gulp 的核心 API 有四个:gulp.task() 、 gulp.src() 、 gulp.dest() 、 gulp.watch() 。
gulp API
gulp API 中文
下面详细介绍一下:
gulp.src()
gulp.src() 可以读取你需要操作的文件,相比于 Grunt 主要以文件为媒介来运行它的工作流,gulp 使用的是 Nodejs 中的 stream 流,首先获取到需要的 stream ,然后可以通过 stream 的 pipe() 方法把流导入到你想要的地方,比如 gulp 的插件中,经过插件处理后的流又可以继续导入到其他插件中,当然也可以把流写入到文件中。所以 gulp 是以 stream 为媒介的,它不需要频繁的生成临时文件,这也是 gulp 的速度比 Grunt 快的一个原因。再回到正题上来,gulp.src() 方法正是用来获取流的,但要注意这个流里的内容不是原始的文件流,而是一个虚拟文件对象流(Vinyl files),这个虚拟文件对象中存储着原始文件的路径、文件名、内容等信息,这个我们暂时不用去深入理解,你只需简单的理解可以用这个方法来读取你需要操作的文件就行了。其语法为:
1 | gulp.src(globs [, options]) |
gulp 用到的 glob 的匹配规则以及一些文件匹配技巧。
gulp 内部使用了 node-glob 模块来实现其文件匹配功能。我们可以使用下面这些特殊的字符来匹配我们想要的文件:
*
匹配文件路径中的 0 个或多个字符,但不会匹配路径分配符,除非路径分隔符出现在末尾- ** 匹配路径中的 0 个或多个目录及其子目录,需要单独出现,即它左右不能有其他东西了。如果出现在末尾,也能匹配文件。
- ? 匹配文件路径中的一个字符(不会匹配路径分隔符)
- […] 匹配方括号中出现的字符中的任意一个,当方括号中第一个字符为 ^ 或 ! 时,则表示不匹配方括号中出现的其他字符中的任意一个,类似 js 正则表达式中的用法。
- !(pattern|pattern|pattern) 匹配任何与括号中给定的任一模式都不匹配的
- ?(pattern|pattern|pattern) 匹配括号中给定的任一模式 0 次或 1 次,类似于 js 正则中的(pattern|pattern|pattern)?
- +(pattern|pattern|pattern) 匹配括号中给定的任一模式至少 1 次,类似于正则中的(pattern|pattern|pattern)+
*(pattern|pattern|pattern)
匹配括号中的给定的任一模式 0 次或多次,类似于 js 正则中的(pattern|pattern|pattern)*
- @(pattern|pattern|pattern) 匹配括号中给定的任一模式 1 次,类似于 js 正则中的(pattern|pattern|pattern)
下面以一系列例子来加深理解
*
能匹配 a.js 、 x.y 、 abc 、 abc/ ,但不能匹配 a/b.js*.*
能匹配 a.js 、 style.css 、 a.b 、 x.y*/*/*.js
能匹配 a/b/c.js 、 x/y/z.js ,不能匹配 a/b.js 、a/b/c/d.js- ** 能匹配 abc 、 a/b.js 、 a/b/c.js 、 x/y/z 、x/y/z/a.b ,能用来匹配所有的目录和文件
- **/*.js 能匹配 foo.js 、 a/foo.js 、 a/b/foo.js 、 a/b/c/foo.js
- a/**/z 能匹配 a/z 、 a/b/z 、 a/b/c/z 、 a/d/g/h/r/z
a/**b/z
能匹配 a/b/z 、 a/fb/z ,但不能匹配 a/x/gb/z ,因为只有单 ** 单独出现才能匹配多级目录- ?.js 能匹配 a.js 、 b.js 、 c.js
- a?? 能匹配 a.b 、 abc ,但不能匹配 ab/ ,因为它不会匹配路径分隔符
- [xyz].js 只能匹配 x.js 、 y.js 、 z.js ,不会匹配 xy.js 、 xyz.js 等,整个中括号只代表一个字符
- [^xyz].js 能匹配 a.js 、 b.js 、 c.js 等,不能匹配 x.js 、 y.js 、 z.js
当有多种匹配模式时可以使用数组
1 | // 使用数组的方式来匹配多种文件 |
使用数组的方式还有一个好处就是可以很方便的使用排除模式,在数组中的单个匹配模式前加上 ! 即是排除模式,它会在匹配的结果中排除这个匹配,要注意一点的是不能在数组中的第一个元素中使用排除模式
1 | gulp.src([*.js,'!b*.js']) //匹配所有 js 文件,但排除掉以 b 开头的 js 文件 |
此外,还可以使用展开模式。展开模式以花括号作为定界符,根据它里面的内容,会展开为多个模式,最后匹配的结果为所有展开的模式想加起来得到的结果。展开的例子如下:
- a{b,c}d 会展开为 abd 、 acd
- a{b,}c 会展开为 abc 、 ac
- a{0..3}d 会展开为 a0d 、 a1d 、 a2d 、 a3d
- a{b,c{d,e}f}g 会展开为 abg 、 acdfg 、 acefg
- a{b,c}d{e,f}g 会展开为 abdeg 、 acdeg 、 abdfg 、 abdeg
gulp.dest()
gulp.dest() 方法是用来写文件的,其语法为:
1 | gulp.dest(path[, options]) |
path 为写入文件的路径
我们给 gulp.dest() 传入的路径参数,只能用来指定要生成的文件的目录,而不能指定生成文件的文件名,它生成文件的文件名使用的是导入到它的文件流自身的文件名,所以生成的文件名是由导入到它的文件流决定的,即使我们给它传入一个带有文件名的路径参数,然后它也会把这个文件名当作是目录名,例如:
1 | var gulp = require("gulp"); |
要想改变文件名,可以使用插件 gulp-rename
下面说说生成的文件路径与我们给 gulp.dest() 方法传入的路径参数之间的关系。
gulp.dest(path) 生成的文件路径是我们传入的 path 参数后面再加上 gulp.src() 中有通配符开始出现的那部分路径。例如:
1 | var gulp = require("gulp"); |
再举更多一点的例子
1 | gulp.src("script/avalon/avalon.js").pipe(gulp.dest("dist")); |
通过指定 gulp.src() 方法配置参数中的 base 属性,我们可以灵活的来改变 gulp.dest() 生成的文件路径。
当我们没有在 gulp.src() 方法配置参数中的 base 属性,base 的默认值为通配符开始出现之前那部分路径,例如:
1 | gulp.src("app/src/**/*.css") //此时base的值为 app/src |
上面我们说的 gulp.dest() 所生成的文件路径的规则,其实也可以理解成,用我们给 gulp.dest() 传入的路径替换掉 gulp.src() 中的 base 路径,最终得到生成文件的路径。
1 | gulp.src("app/src/**/*.css").pipe(gulp.dest("dist")); |
所以改变 base 路径后,gulp.dest() 生成的文件路径也会改变
1 | gulp.src("script/lib/*.js").pipe(gulp.dest("build")); |
用 gulp.dest() 把文件流写入文件后,文件流仍然可以继续使用。
gulp.task()
gulp.task 方法用来定义任务,内部使用的是 Orchestrator ,其语法为:
1 | gulp.task(name[, deps], fn) |
name 为任务名,如果你需要在命令行中运行你的某些任务,那么,请不要在名字中使用空格。
deps 是当前定义的任务需要依赖的其他任务,为一个数组。当前定义的任务会在所有依赖的任务执行完毕后才开始执行。如果没有依赖,则可省略这个参数。
fn 为任务函数,我们把任务要执行的代码都要写在里面。该参数也是可选的。
1 | gulp.task("mytask", ["array", "of", "task", "names"], function() { |
关于 gulp.task() ,我们需要知道执行多个任务时怎么来控制任务执行的顺序。
gulp 中执行多个任务,可以通过任务依赖来实现。例如我想要执行 one ,two ,three 这三个任务,那我们就可以定义一个空的任务,然后把那三个任务当做这个空的任务的依赖就行了:
1 | //只要执行default任务,就相当于把one,two,three这三个任务执行了 |
如果任务相互之间没有依赖,任务会按你书写的顺序来执行,如果有依赖的话则会先执行依赖的任务。
但是如果某个任务所依赖的任务是异步的,就要注意了,gulp 并不会等待那个所依赖的异步任务完成,而是会接着执行后续的任务。例如:
1 | gulp.task('one', function(){ |
上面的例子中我们执行 two 任务时,会先执行 one 任务,但不会去等待 one 任务中的异步操作完成后再执行 two 任务,而是紧接着执行 two 任务。因为 one 任务耗时 3 秒,所以 two 任务会在 one 任务中的异步操作完成之前就执行了。
那如果我们想等待异步任务中的异步操作完成后再执行后续的任务,该怎么做呢?
有三种方法可以实现:
第一:在异步操作完成后执行一个回调函数来通知 gulp 这个异步任务已经完成,这个回调函数就是任务函数的第一个参数。
1 | gulp.task("one", function(cb) { |
第二:定义任务时返回一个流对象。适用于任务就是操作 gulp.src 获取到的流的情况。
1 | gulp.task("one", function(cb) { |
第三:返回一个 promise 对象,例如:
1 | var Q = require('q'); //一个著名的异步处理的库 https://github.com/kriskowal/q |
关于 gulp.task() ,主要的就是要清除当依赖异步任务时要如何处理。
gulp.watch()
gulp.watch() 用来监视文件的变化,当文件发生变化后,我们可以利用它来执行相应的任务,例如文件压缩等。其语法为:
1 | gulp.watch(glob[, opts], tasks); |
glob 为要监视的文件匹配模式,规则和用法与 gulp.src() 方法中的 glob 相同。
opts 为一个可选的配置对象,通常不需要用到。
tasks 为文件变化后要执行的任务,为一个数组
1 | gulp.task("uglify", function() { |
gulp.watch(glob [,opts, cb])
glob 和 opts 参数与第一种用法相同
cb 参数为一个函数。每当监视的文件发生变化时,就会调用这个函数,并且会给它传入一个对象,该对象包含了文件变化的一些信息,type 属性为变化的类型,可以是 added 、changed 、deleted ,path 属性为发生变化的文件的路径
1 | gulp.watch("js/**/*.js", function(event){ |
gulp 的插件
gulp 本身虽然不能完成很多任务,但它有大量插件可用,我们可以在 插件页面 或者在 npm 搜索 gulpplugin 。
列一些很棒的 plugin :
- JSHint : js代码检查分析工具
- gulp-coffee : 编译CoffeeScript
- gulp-mocha : 执行Mocha测试
- gulp-bump : 更新版本号
- gulp-sass : sass 编译
- browser-sync : 浏览器自动刷新
- gulp-uglify : 代码压缩
- gulp-concat : 合并
- gulp-eslint : 支持 ES6 JSX
gulp 命令行参数
-v
或--version
会显示全局和项目本地所安装的 gulp 版本号--require <module path>
将会在执行之前 require 一个模块。这对于一些语言编译器或者需要其他应用的情况来说很有用。你可以使用多个--require
--gulpfile <gulpfile path>
手动指定一个 gulpfile 的路径,这在你有很多个 gulpfile 的时候很有用。这也会将 CWD 设置到该 gulpfile 所在目录--cwd <dir path>
手动指定 CWD 。定义 gulpfile 查找的位置,此外,所有的相应的依赖(require)会从这里开始计算相对路径-T
或--tasks
会显示所指定 gulpfile 的 task 依赖树--tasks-simple
会以纯文本的方式显示所载入的 gulpfile 中的 task 列表--color
强制 gulp 和 gulp 插件显示颜色,即便没有颜色支持--no-color
强制不显示颜色,即便检测到有颜色支持--silent
禁止所有的 gulp 日志
命令行会在 process.env.INIT_CW 中记录它是从哪里被运行的。
tip
1、gulp 写进项目 package.json 文件的依赖有什么作用
方便别人查看你项目中有些什么依赖,而且在项目目录下执行 npm install 命令会安装项目 package.json 中的所有依赖模块,这样就能简化项目的安装程序了,不用一个一个模块去安装啊。
2、gulp 中着重了解 gulp.task() 如何处理依赖任务是耗时操作或者异步操作的情况。
- 感谢您的赞赏。