Javascript 如何生成Less和Js的Source map

为什么有Source map

    CSS和JS脚本正变得越来越复杂,为了解决网络瓶颈,大部分源代码都需要经过编译、合并、压缩才能运用到实际环境中。为了减少网络资源占用,源码一般都会经过以下方式处理:

    使用css框架合并压缩css文件;
    使用js合并插件,减少网络请求次数;
    压缩js文件,降低网络占用;

    这三种方式都可以有效的解决实际问题,但同时在运行调试过程中也带来麻烦,由于css和js都是经过了压缩转换,当报错时我们很难定位到源代码具体位置。为了解决这个问题,Source map由此诞生。

什么是Source map

    Source map相当于一个映射文件,它提供了转换后的代码,所对应源代码的位置。也就是说,在调试js过程中,我们可以清楚的看到当前执行代码对应于源代码的具体位置。

    支持的浏览器:目前对Source map支持最好的应该是Chrome浏览器。

    如何打开Chrome的Source map功能:
    第一步,打开Developer Tools工具,选择菜单View -> Developer -> Developer Tools
    第二步,选择右上角的Settings菜单
    第三步,选择General页签,勾选Enable source maps。

如何在项目中使用Source map

    一般有两类文件需要使用Source map:css和js。由于我的项目使用gulp环境。所有我主要介绍生成Source map的gulp插件。
要使用gulp,先得使用npm下载gulp:gulp下载

 

    在下载插件之前,先创建一个项目,命名为beautJs。项目目录结构如下:

    beautJs
    ----assets
        ----less
            ----login.less
            ----main.less
    ----view
        ----login.js
        ----main.js

----node_modules
----gulpfile.js
----index.html
----package.json

    接下来,看看如何生成Source map文件。

Less如何生成Source map

    css编码,我使用了less框架。要生成css的Source map文件,需要下载gulp-less和gulp-sourcemaps插件:
    gulp-less:css编码框架,使用介绍
    gulp-sourcemaps:css生成source map,使用介绍

    接下来就需要配置gulpfile.js文件,在使用gulp插件先得引入进来。在文件的头部添加代码:

var gulp = require('gulp');
var sourcemaps = require('gulp-sourcemaps');
var less = require('gulp-less');

    然后添加gulp的task任务,代码如下:

gulp.task('less', function() {
    return gulp.src(['assets/less/index.less'])
        .pipe(sourcemaps.init())
        .pipe(less({compress: true}))
        .pipe(sourcemaps.write("./"))
        .pipe(gulp.dest('dist/assets/styles'));
});

    说明:index.less引入了assets/less下的所有模块less文件:

@import "login";
@import "main";

    所以在编译时只用编译index.less文件即可。配置完成后,我们就可以使用node.js命令行工具执行命令:

gulp less

    最终在根目录下生成了一个dist文件夹,目录结构如下:

    dist
    ----assets
    ----index.css
    ----index.css.map

 

    打开index.css文件,查看代码:

.login-body{background:#fff}.login-body .login-item{background:#fff}.main-body{background:#fff}.main-body .main-item{background:#fff}
/*# sourceMappingURL=index.css.map */

    在文件的最后一行能看到下面的代码:

/*# sourceMappingURL=index.css.map */

    这含代码是Source map的关键所在,有了这行代码,我们在使用chrome浏览器时就可以看到index.css对应的源代码所在位置。当然,在上线项目时,我们也可以移除改行代码。
    现在只需要在index.html文件中引入index.css文件就可以使用所有的样式资源了。

Js如何生成Source map

    Js文件在项目中是通过模块划分,一个模块一个文件。随着项目的复杂度增加,模块数量也逐渐增多。可以使用gulp-concat插件合并js文件。需要使用的插件如下:
    gulp-concat: 文件合并,使用介绍
    gulp-uglify:js文件压缩,使用介绍
    gulp-sourcemaps:js生成source map,使用介绍

 

    接下来就配置gulpfile.js文件,在使用gulp插件先得引入进来。在文件的头部添加代码:

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

    然后添加gulp的task任务,代码如下:

gulp.task('uglify', function () {
    return gulp.src('view/*.js')
        .pipe(sourcemaps.init({loadMaps: true}))
        .pipe(concat('index.min.js'))
        .pipe(uglify())
        .pipe(sourcemaps.write('/'))
        .pipe(gulp.dest('dist/view'));
});

    目前,gulpfile.js文件里边已经有less和uglify两个任务了,我们可以使用gulp的watch功能,监听less和js文件是否有更新,有更新立即执行less和uglify两个任务。到目前gulpfile.js文件的完整代码如下:

/**
 * 构建任务
 */
var gulp = require('gulp');
var sourcemaps = require('gulp-sourcemaps');
var less = require('gulp-less');
var uglify = require('gulp-uglify');
var concat = require('gulp-concat');

gulp.task('less', function() {
    return gulp.src(['assets/less/index.less'])
        .pipe(sourcemaps.init())
        .pipe(less({compress: true}))
        .pipe(sourcemaps.write("./"))
        .pipe(gulp.dest('dist/assets/styles'));
});

gulp.task('uglify', function () {
    return gulp.src('view/*.js')
        .pipe(sourcemaps.init({loadMaps: true}))
        .pipe(concat('index.min.js'))
        .pipe(uglify())
        .pipe(sourcemaps.write('/'))
        .pipe(gulp.dest('dist/view'));
});

gulp.task("serve:build", ['less', 'uglify'], function(){
    gulp.watch("assets/less/**/*.less", ['less']);
    gulp.watch("view/*.js", ['uglify']);
});

    配置完成后,我们就可以使用node.js命令行工具下面的命令:

gulp serve: build

    最终在根目录dist文件夹下生成views文件夹,dist目录结构如下:

    dist
    ----assets
        ----index.css
        ----index.css.map
    ----views
        ----index.js
        ----index.js.map
   

    打开index.js文件,查看源码:

function login(){}function main(){}
//# sourceMappingURL=index.min.js.map

    在文件的最后一行能看到下面的代码:  

/*# sourceMappingURL=index.js.map */

    现在只需要在index.html文件中引入index.js文件即可。源码如下:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>BeautJs</title>
    <link rel="stylesheet" href="dist/assets/styles/index.css" />
    <script type="text/javascript" src="dist/view/index.min.js"></script>
</head>
<body>
</body>
</html>

    下图是我测试项目目录截图:

image

   

总结

    以上步骤完成后,我们再也不用关心js文件或者css文件的引用问题,并且在项目运行时性能也会有提升:通过合并文件减少网络请求次数。通过压缩文件减低网络占用率。

    最后附上测试工程的git地址:https://github.com/heavis/BeautJs

   

   如果本篇内容对大家有帮助,请点击页面右下角的关注。如果觉得不好,也欢迎拍砖。你们的评价就是博主的动力!下篇内容,敬请期待!

posted @ 2016-07-24 21:31  heavi  阅读(2259)  评论(1编辑  收藏  举报