正文

前端构建工具 Gulp 压缩合并JS/CSS 并添加版本号、ES6转ES5

IP云
IP云V管理员/4 阅读
10/31
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

Gulp 基于 Node.js 的前端构建工具，可以实现前端代码的编译（sass、less）、压缩合并（JS、CSS）、测试；图片的压缩；已经添加 JS 和 CSS 版本号，防止浏览器缓存。

1. 安装

全局安装

$ npm install gulp -g

进入项目跟目录，初始化 npm init ， 然后安装：

$ npm install gulp

安装插件

  • sass的编译（gulp-ruby-sass）
  • 自动添加css前缀（gulp-autoprefixer）
  • 压缩css（gulp-clean-css）
  • 压缩js代码（gulp-uglify）
  • 压缩图片（gulp-imagemin）
  • 合并文件（gulp-concat）
  • 图片缓存插件（gulp-cache）
  • 编译提醒（gulp-notify）
  • 清除文件（del）
  • 自动添加版本号（gulp-rev-collector 、 gulp-rev）
  • ES6 转 ES5 （gulp-babel、babel-preset-es2015、babel-core）

注意，避免 gulp-babel 编译时出现Cannot find module '@babel/core'， gulp-babel 的版本建议安装7.0.1 ($ npm install gulp-babel@7 --save-dev)

2. 配置项目

"dependencies": {
"babel-core": "^6.26.3",
"del": "^4.1.1",
"gulp": "^4.0.1",
"gulp-autoprefixer": "^6.1.0",
"gulp-cache": "^1.1.1",
"gulp-clean-css": "^4.2.0",
"gulp-concat": "^2.6.1",
"gulp-imagemin": "^5.0.3",
"gulp-jshint": "^2.1.0",
"gulp-notify": "^3.2.0",
"gulp-rename": "^1.4.0",
"gulp-rev": "^9.0.0",
"gulp-rev-append": "^0.1.8",
"gulp-rev-collector": "^1.3.1",
"gulp-ruby-sass": "^4.0.0",
"gulp-uglify": "^3.0.2",
"jshint": "^2.10.2"
},
"devDependencies": {
"babel-preset-es2015": "^6.24.1",
"gulp-babel": "^7.0.1"
}

注意各个插件的版本号，升级后可能报错

3. 引入插件

创建文件 gulpfile.js:

var gulp = require('gulp'),
babel = require('gulp-babel'),
rev = require('gulp-rev'),
revCollector = require('gulp-rev-collector'),
cleanCSS = require('gulp-clean-css'),
autoprefixer = require('gulp-autoprefixer'),
uglify = require('gulp-uglify'),
imagemin = require('gulp-imagemin'),
rename = require('gulp-rename'),
concat = require('gulp-concat'),
notify = require('gulp-notify'),
cache = require('gulp-cache'),
del = require('del');

4. 合并、压缩css, 并添加不同浏览器的前缀

gulp.task('css', function () {
// 找到 src/css/ 下的所有 css 文件
return gulp.src('src/css/**/*.css')
// 添加前缀(如：-webkit-)
.pipe(autoprefixer('last 2 version', 'safari 5', 'ie 8', 'ie 9', 'opera 12.1', 'ios 6', 'android 4'))
// 合并为一个css
.pipe(concat('main.css'))
// 合并后的css 保存到 dist/css 下
.pipe(gulp.dest('dist/css'))
// 重命名
.pipe(rename({ suffix: '.min' }))
// 压缩css
.pipe(cleanCSS())
.pipe(rev())
.pipe(gulp.dest('dist/css'))
//CSS 生成文件 hash 编码并生成 rev-manifest.json 文件，里面定义了文件名对照映射
.pipe(rev.manifest())
.pipe(gulp.dest('rev/css'))
.pipe(notify({ message: 'css 文件压缩完成' }));
});

执行 $ gulp css 后，会在 dist 目录下 生成两个文件：main.css 和 main-e25b0dac62.min.css（其中e25b0dac62是一个随机的版本号）。

另外，还会生成了一个文件 rev/css/rev-manifest.json, 里面定义了css对应的版本号映射：

{
"main.min.css": "main-e25b0dac62.min.css"
}

5. js 代码合并和压缩

gulp.task('js', function () {
return gulp.src('src/js/**/*.js')
// 编译es6
.pipe(babel())
.pipe(concat('main.js'))
.pipe(gulp.dest('dist/js'))
.pipe(rename({ suffix: '.min' }))
.pipe(rev())
.pipe(uglify())
.pipe(gulp.dest('dist/js'))
.pipe(rev.manifest())
.pipe(gulp.dest('rev/js'))
.pipe(notify({ message: 'js 文件编译完成' }));
});

5.1 注意：如果需要制定js的压缩先后顺序，可以在src中通过数组的形式按先后顺序写入：

gulp.src(['src/js/b.js','src/js/dashboard.js','src/js/common.js','src/js/a.js',])

5.2 编译es6

需要在根目录创建一个 .babelrc 文件：

{
"presets": ["es2015"]
}

6. 压缩图片

gulp.task('images', function () {
return gulp.src('src/images/**/*')
.pipe(cache(imagemin({ optimizationLevel: 5, progressive: true, interlaced: true })))
.pipe(gulp.dest('dist/images'))
.pipe(notify({ message: '图片压缩完成' }));
});

7. Html中替换成包含版本号的css、js文件

其中： gulp.src()的第一个参数：生成的json文件的路径，这里将所有的js和css对应的json文件都选中；第二个参数：要替换css,js文件(路径)的HTML文件

gulp.task('html', function () { return gulp.src(['rev/**/*.json', 'src/**/*.html'])
.pipe(revCollector({
replaceReved: true, // 设置replaceReved标识, 用来说明模板中已经被替换的文件是否还能再被替换,默认是false
}))
.pipe(gulp.dest('dist'));
});

8. 清空目标文件

建议在每次任务执行前，先清除之前生成的文件：

gulp.task('clean', done => {
del(['dist/css', 'dist/js', 'dist/html', 'dist/images'])
console.log('----------------清空文件-------------------')
done()
});

9. 设置默认任务（default）

默认任务指定执行上面写好的三个任务：

gulp.task('default', gulp.series('clean', gulp.parallel('css', 'js', 'images'), 'html', done => {
console.log('-----------全部执行完毕------------------')
done();
}));

运行：

$ gulp

默认的名为 default 的任务（task）将会被运行。

执行完成后，会在 dist 目录下出现所有执行后的 js、css、html、images。

注意gulp 执行顺序：

  • gulp.series 用于串行（顺序）执行
  • gulp.parallel 用于并行执行

项目初始目录：

编译后目录：

gulpfile.js 代码：

var gulp = require('gulp'),
babel = require('gulp-babel'),
rev = require('gulp-rev'),
revCollector = require('gulp-rev-collector'),
cleanCSS = require('gulp-clean-css'),
autoprefixer = require('gulp-autoprefixer'),
uglify = require('gulp-uglify'),
imagemin = require('gulp-imagemin'),
rename = require('gulp-rename'),
concat = require('gulp-concat'),
notify = require('gulp-notify'),
cache = require('gulp-cache'),
del = require('del');// 文件路径
var paths = {
css: {
src: 'src/css/**/*.css',
dest: 'dist/css/',
rev: 'rev/css/'
},
js: {
src: ['src/js/a.js','src/js/common.js','src/js/dashboard.js','src/js/b.js',],
dest: 'dist/js/',
rev: 'rev/js/'
},
images: {
src: 'src/images/**/*',
dest: 'dist/images/'
}
};// 合并 压缩 css， 自动添加不同浏览器的前缀
gulp.task('css', function () {
// 找到 src/css/ 下的所有 css 文件
return gulp.src(paths.css.src)
// 添加前缀(如：-webkit-)
.pipe(autoprefixer('last 2 version', 'safari 5', 'ie 8', 'ie 9', 'opera 12.1', 'ios 6', 'android 4'))
// 合并为一个css
.pipe(concat('main.css'))
// 合并后的css 保存到 dist/css 下
.pipe(gulp.dest(paths.css.dest))
// 重命名
.pipe(rename({ suffix: '.min' }))
// 压缩css
.pipe(cleanCSS())
.pipe(rev())
.pipe(gulp.dest(paths.css.dest))
//CSS 生成文件 hash 编码并生成 rev-manifest.json 文件，里面定义了文件名对照映射
.pipe(rev.manifest())
.pipe(gulp.dest(paths.css.rev))
.pipe(notify({ message: 'css 文件压缩完成' }));
});// js 代码合并和压缩
gulp.task('js', function () {
return gulp.src(paths.js.src)
.pipe(babel())
.pipe(concat('main.js'))
.pipe(gulp.dest(paths.js.dest))
.pipe(rename({ suffix: '.min' }))
.pipe(rev())
.pipe(uglify())
.pipe(gulp.dest(paths.js.dest))
.pipe(rev.manifest())
.pipe(gulp.dest(paths.js.rev))
.pipe(notify({ message: 'js 文件编译完成' }));
});// 压缩图片
gulp.task('images', function () {
return gulp.src(paths.images.src)
.pipe(cache(imagemin({ optimizationLevel: 5, progressive: true, interlaced: true })))
.pipe(gulp.dest(paths.images.dest))
.pipe(notify({ message: '图片压缩完成' }));
});//Html替换css、js文件版本
gulp.task('html', function () {
return gulp.src(['rev/**/*.json', 'src/**/*.html'])
.pipe(revCollector({
replaceReved: true,
}))
.pipe(gulp.dest('dist'));
});// 清空目标文件
// 在任务执行前，先清除之前生成的文件：
gulp.task('clean', done => {
del(['dist/css', 'dist/js', 'dist/html', 'dist/images'])
console.log('----------------清空文件-------------------')
done()
});// 设置默认任务（default）
gulp.task('default', gulp.series('clean', gulp.parallel('css', 'js', 'images'), 'html', done => {
console.log('-----------全部执行完毕------------------')
done();
}));

index.html 编译前

src/html/index.html:

<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>标题</title>
<link rel="stylesheet" href="../css/main.min.css">
</head>
<body>
<div id="main">
<div class="box">
<div class="item">
<h3>