npm install gulp --save-dev
gulp 是新一代的前端建構工具,能編譯 Less/Sass、壓縮 JS 與 CSS、甚至壓縮圖片。它只提供少量 API,因此學習曲線平緩;核心特色是以串流(stream)方式處理檔案,不必反覆寫入暫存檔。Node 生態誕生過 Bower、Yeoman、Grunt 等自動化工具,gulp 則以更簡潔的模型勝出。
因為 gulp 以 Node.js 撰寫,需先安裝 Node 與 npm,接著全域安裝 gulp:
sudo npm install -g gulp
在專案根目錄建立 package.json:
npm init
安裝完成後可用 gulp -v 確認版本:

gulp-ruby-sassgulp-autoprefixergulp-minify-cssgulp-jshintgulp-concatgulp-uglifygulp-imagemingulp-livereloadgulp-cachegulp-notifydel/gulp-clean一次安裝:
npm install gulp-ruby-sass gulp-autoprefixer gulp-minify-css gulp-jshint gulp-concat gulp-uglify gulp-imagemin gulp-notify gulp-rename gulp-livereload gulp-cache del --save-dev
--save 會把模組與版本寫進 dependencies,--save-dev 則寫進 devDependencies,可以省下手動編輯 package.json 的步驟。
gulp.task(name[, deps], fn):定義任務,name 為任務名、deps 為相依任務、fn 為回呼。gulp.run(tasks...):盡可能平行執行多個任務。gulp.watch(glob, fn):檔案符合 glob 有變動時執行 fn。gulp.src(glob):指定要處理的來源檔案,可用陣列或正則。gulp.dest(path[, options]):指定輸出位置。其中 glob 是檔案路徑的模式比對,gulp 會把符合的檔案透過 pipe() 導向各插件處理。
gulp.task('default', function () { /* ... */ });
定義好之後,在命令列輸入 gulp default(或 gulp)即可執行。官方 API 文件:gulpjs/gulp API.md;插件目錄:gulpjs.com/plugins。
在專案根目錄建立 gulpfile.js(檔名不可更改):
var gulp = require('gulp');
var uglify = require('gulp-uglify');
gulp.task('compress', function () {
return gulp.src('script/*.js')
.pipe(uglify())
.pipe(gulp.dest('dist'));
});
先安裝相依插件:
npm install --save-dev gulp-uglify npm install --save-dev gulp-rename
加上重新命名後:
var gulp = require('gulp');
var uglify = require('gulp-uglify');
var rename = require('gulp-rename');
gulp.task('compress', function () {
return gulp.src('script/*.js')
.pipe(uglify())
.pipe(rename('jquery.ui.min.js'))
.pipe(gulp.dest('dist'));
});

// 載入外掛
var gulp = require('gulp'),
sass = require('gulp-ruby-sass'),
autoprefixer = require('gulp-autoprefixer'),
minifycss = require('gulp-minify-css'),
jshint = require('gulp-jshint'),
uglify = require('gulp-uglify'),
imagemin = require('gulp-imagemin'),
rename = require('gulp-rename'),
clean = require('gulp-clean'),
concat = require('gulp-concat'),
notify = require('gulp-notify'),
cache = require('gulp-cache'),
livereload = require('gulp-livereload');
// 樣式
gulp.task('styles', function () {
return gulp.src('src/styles/main.scss')
.pipe(sass({ style: 'expanded' }))
.pipe(autoprefixer('last 2 version', 'safari 5', 'ie 8', 'ie 9', 'opera 12.1', 'ios 6', 'android 4'))
.pipe(gulp.dest('dist/styles'))
.pipe(rename({ suffix: '.min' }))
.pipe(minifycss())
.pipe(gulp.dest('dist/styles'))
.pipe(notify({ message: 'Styles task complete' }));
});
// 腳本
gulp.task('scripts', function () {
return gulp.src('src/scripts/**/*.js')
.pipe(jshint('.jshintrc'))
.pipe(jshint.reporter('default'))
.pipe(concat('main.js'))
.pipe(gulp.dest('dist/scripts'))
.pipe(rename({ suffix: '.min' }))
.pipe(uglify())
.pipe(gulp.dest('dist/scripts'))
.pipe(notify({ message: 'Scripts task complete' }));
});
// 圖片
gulp.task('images', function () {
return gulp.src('src/images/**/*')
.pipe(cache(imagemin({ optimizationLevel: 3, progressive: true, interlaced: true })))
.pipe(gulp.dest('dist/images'))
.pipe(notify({ message: 'Images task complete' }));
});
// 清理
gulp.task('clean', function () {
return gulp.src(['dist/styles', 'dist/scripts', 'dist/images'], { read: false })
.pipe(clean());
});
// 預設任務
gulp.task('default', ['clean'], function () {
gulp.start('styles', 'scripts', 'images');
});
// 看守
gulp.task('watch', function () {
gulp.watch('src/styles/**/*.scss', ['styles']);
gulp.watch('src/scripts/**/*.js', ['scripts']);
gulp.watch('src/images/**/*', ['images']);
var server = livereload();
gulp.watch(['dist/**']).on('change', function (file) {
server.changed(file.path);
});
});
關鍵觀念:pipe() 是 stream 模組傳遞資料流的方法,上游檔案流進插件、加工後再往下游流。任務的骨架永远是:
gulp.task('任務名稱', function () {
return gulp.src('來源路徑')
.pipe(插件A())
.pipe(插件B())
.pipe(gulp.dest('輸出路徑'));
});
gulp-gh-pages:把靜態檔案推到 GitHub Pages。
var gulp = require('gulp');
var ghPages = require('gulp-gh-pages');
gulp.task('deploy', function () {
return gulp.src('./dist/**/*').pipe(ghPages());
});
gulp-less:編譯 Less。
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-live-server:輕量開發伺服器。
var gulp = require('gulp');
var gls = require('gulp-live-server');
gulp.task('serve', function () {
var server = gls.static('dist', 8888);
server.start();
gulp.watch(['static/**/*.css', 'static/**/*.html'], function (file) {
server.notify.apply(server, [file]);
});
});
gulp-load-plugins:自動載入 package.json 中所有以 gulp- 為前綴的插件,不必逐一 require。
var gulp = require('gulp');
var gulpLoadPlugins = require('gulp-load-plugins');
var plugins = gulpLoadPlugins();
gulp-babel:把 ES2015 語法轉譯為相容寫法。
npm install --save-dev gulp-babel babel-preset-es2015
const gulp = require('gulp');
const babel = require('gulp-babel');
gulp.task('default', () => {
return gulp.src('src/app.js')
.pipe(babel({ presets: ['es2015'] }))
.pipe(gulp.dest('dist'));
});
官方專案位置:github.com/gulpjs/gulp。掌握了 task、src、pipe、dest、watch 這幾個積木,就足以應付絕大多數的前端建構需求。