项目使用gulp的配置编译sass笔记

Node环境

通过 node.js 网站下载了安装包进行安装 node.js, npm也会一起安装

1
2
3
node --version # 查看node.js版本
npm --version #查看npm版本
npx --version

通过命令配置 npm 淘宝镜像

1
2
3
npm config set registry https://registry.npm.taobao.org
npm config get registry #验证命令
npm config list #列出当前npm的配置列表

定位到项目目录

通过命令行工具进入到 项目的工作目录,如 windows系统下,我的项目目录是D:/workspace/nodejs/gulpstart

cmd 命令是:

1
2
3
cd D:
cd workspace/nodejs/gulpstart
dir # 列出当前目录的文件

成功进入到项目目录后,我们开始安装 gulp。

安装gulp

NPM是基于命令行的node包管理工具,它可以将node的程序模块安装到项目中,在它的官网中可以查看和搜索所有可用的程序模块。

如果在项目目录下没有 名为package.json 文件,可通过

1
npm init

命令来初始化一个 package.json 文件的信息,如已有package.json文件,可略过npm init 这个命令。

安装 gulp,作为开发时依赖项:

1
2
3
npm install --global gulp-cli # 安装
gulp -v #查看安装的 gulp版本
npm install —-save-dev gulp

上面命令中的--save-dev的包名来更新package.json文件中,更新devDependencies键的值,以表明项目需要依赖gulp。

Dependencies可以向其他参与项目的人指明项目在开发环境和生产环境中的node模块依懒关系,想要更加深入的了解它可以看看Specifying dependencies and devDependencies in a package.json file文档。

创建Gulpfile文件,运行gulp

安装依赖

1
npm install gulp-jshint node-sass gulp-sass gulp-concat gulp-uglify gulp-rename gulp-clean-css browser-sync  --save-dev

安装的插件说明:

  • gulp-jshint : js语法检查
  • gulp-sass : sass
  • gulp-concat : 文件合并(Concatenates files)
  • gulp-uglify : js 文件压缩(Minify JavaScript with UglifyJS3.)
  • gulp-rename : 重命名文件
  • gulp-clean-css: 压缩css文件需要使用到的

如果需要其它的gulp 插件,可到 npmjs 查找gulp-开头的包(package),如: gulp-less less

新建gulpfile文件

现在,需要使用的gulp组件都安装完毕,我们需要新建一个gulpfile文件以指定gulp需要为我们完成什么任务。

gulp 有五个方法: task,run,watch,src,和dest,在项目根目录新建一个名为gulpfile.js (或者首字母大写 Gulpfile.js,就像 Makefile 一样命名) 的文件,

  • task: 每个 gulp 任务(task)都是一个异步的 JavaScript 函数
  • run: 执行任务(task)
  • watch: gulp api 中的 watch() 方法利用文件系统的监控程序(file system watcher)将 globs 与 任务(task) 进行关联。
  • src和dest gulp 暴露了 src() 和 dest() 方法用于处理计算机上存放的文件

说明: 上面内容都是抄自 gulp 中文网文档 网站

把下面的代码粘贴进去:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
'use strict';
// 引入 gulp
var gulp = require('gulp');

// 引入组件
var sass = require('gulp-sass');
var concat = require('gulp-concat');
var uglify = require('gulp-uglify');
var rename = require('gulp-rename');
sass.compiler = require('node-sass');
var cleanCss = require('gulp-clean-css'); // css压缩

var browserSync = require('browser-sync').create();
var reload = browserSync.reload;

// 编译Sass
//Sass任务会编译scss/目录下的scss文件,并把编译完成的css文件保存到/css目录中。

gulp.task('sass', function () {
return gulp.src('./assets/scss/**/*.scss')
.pipe(sass({outputStyle: 'compressed'}).on('error', sass.logError))
.pipe(gulp.dest('./assets/css'));
});


// 合并任务: 将css下的多个css文件合并输出到build/css下面
gulp.task('concat', function(){
return gulp.src(['./assets/css/home.css', './assets/css/contact.css','./assets/css/hello.css'])
.pipe(concat('main.css'))
.pipe(cleanCss())
.pipe(gulp.dest('./assets/css'))
.pipe(reload({stream: true}))
});

// 合并,压缩文件
//scripts任务会合并js/目录下得所有得js文件并输出到dist/目录,然后gulp会重命名、压缩合并的文件,也输出到dist/目录。
// gulp.task('scripts', function() {
// gulp.src('./js/*.js')
// .pipe(concat('all.js'))
// .pipe(gulp.dest('./dist'))
// .pipe(rename('all.min.js'))
// .pipe(uglify())
// .pipe(gulp.dest('./dist'));
// });

// 默认任务
gulp.task('default', function(){
gulp.run('sass');

// 监听文件变化
// gulp.watch('./js/*.js', function(){
// gulp.run('lint', 'sass', 'scripts');
// });

gulp.watch('./assets/scss/*.scss', function(){
gulp.run('sass');
});
});

上面的gulp 配置可按照实际的情况进行修改,添加,删除。

在项目目录运行命令:

1
2
gulp sass # 編譯sass 文件
gulp concat # css文件合併

References

1.前端构建工具gulp入门教程
2.gulp中文网
3.npm使用国内淘宝镜像的方法