webpack&gulp集成简介

webpack简单介绍

webpack is a bundler for modules. The main purpose is to bundle JavaScript files for usage in a browser, yet it is also capable of transforming, bundling, or packaging just about any resource or asset.摘自github webpack页面。webpack以CommonJS规范在本地对js进行模块化处理打包,不再需要引入requirejs或seajs。可以通过不同的loader来对其他格式的文件进行处理。接下来会介绍下如何使用gulp和webpack来处理前端代码,并且会介绍一些集成过程中遇到的坑。文中最后把gulpfile.js和package.json里面的代码贴出来,仅供参考。

gulp和webpack集成使用介绍

安装完Nodejs环境后,把本文后面的package.json文件安装,gulp要全局安装(npm install gulp -g)。

  • 创建webpack对象
var webpack = require("webpack")
  • 创建gulp默认任务
//gulp --product
gulp.task('default', function() {
    isProduct = argv.product;
    isWatch = !isProduct;
    console.log('正在处理:' + (isProduct ? '线上' : '本地') + '环境');
    fse.emptydirSync('./dist');
    gulp.start('webpack');
});

本地开发(命令:gulp)和线上(命令:gulp --product)部署gulp命令分开,本地会做文件更改的监听,并且不会压缩。

ps:fse库是对自带的fs库做了很好的扩展,推荐使用。

  • webpack任务配置

最全配置代码参考gulpfile.js。

入口文件配置:

entry: {
            index: './index.js'
            common: [
                'jquery',
                'understore',
                'template',
                'store'
            ]
        }

该参数主要是配置入口文件,打包出来的文件就是以里面的key作为名字的文件(即bundle)。

==注意点:[]和字符串的区别,如果是字符串(比如:'./index,js'),那么该文件(index.js)是不能在其他模块进行require的,如果既要作为入口文件又要在其他模块require,那么需要用数组的方式配置,即['./index.js']。可以看下打包后的代码,字符串的配置该文件代码会在索引为0的地方,如果配置成数组,则位置为0的函数中是没有自己代码的,只是来执行其他模块的代码==

输出路径配置:

output: {
            path: './dist/',
            filename: '[name].js',
            publicPath: ''
        }

文件会被输出到dist目录下,文件名是以当前文件名做为输出后的文件名。

别名配置:

resolve: {
            alias: {
                jquery: path.resolve('../global/lib/jquery.js'),
                template: path.resolve('../global/lib/template.js'),
                understore: path.resolve('../global/lib/underscore.js'),
                store: path.resolve('../global/lib/store.js')
            }
        }

配置完别名,就可以用别名来进行require了,不管是在webpack配置中,还是在js代码中。比如,在entry中的common模块就可以直接用understore,在打包时就会通过别名找到具体的路径。==别名的值最好是绝对路径,当时我们用相对路径如果只是同一个目录结构没有问题,但是多个目录结构的引用就会出现路径解析错误。绝对路径转换使用path.resolve该方法即可==

webpack插件:

一些特殊功能可以通过webpack插件进行完成。

1)webpack内部全局变量

new webpack.ProvidePlugin({
    $: 'jquery',
    jQuery: 'jquery',
    template: 'template',
    store: 'store',
    _: 'understore'
})

配置完全局的变量,在js中就直接可以用,不需要再require。该全局不是挂载到window对象上,只对webpack打包出来的js有用。

2)模块唯一插件
new webpack.optimize.DedupePlugin()

该插件会把相同的模块合并,不推荐使用,最好自己做到模块唯一性,如果打出来两个相同的模块,说明你的代码潜藏出错风险

3)css抽离插件
new ExtractTextPlugin("[name].css")

该插件会把css抽离出来作为单独的css文件进行打包,如果不使用该插件,会把css打包到js中,然后以style标签的形式,把css作为内联样式使用。

4)公共文件插件
new webpack.optimize.CommonsChunkPlugin('common', 'common.js')

该插件会把公共的模块进行抽离到公共的js模块里面,防止js重复引用打包。

5)压缩插件

new webpack.optimize.UglifyJsPlugin({
        compress: {
            warnings: false
        },
        mangle: {
            except: ['$', 'm', 'webpackJsonpCallback']
        }
    })

该插件会把js进行压缩,在线上环境进行使用。mangle该关键词不需要混淆,因为在我们实践过程中,压缩后的代码有很多地方报错,故上面3个不混淆的值是根据我们自身项目来的。

sourcemap:

由于webpack会把所有的js都打包到一个js文件中,这样就不方便开发人员debug,故需要进行sourcemap的配置

devtool: (isProduct ? false : 'source-map')

线上环境不需要sourcemap,加上source-map参数,会在打包的时候打出来map文件,chrome浏览器会解析sourcemap进行定位到相应的文件。

加载器loader:

1)js加载器

{
    test: /\.js[x]?$/,
    exclude: /node_modules/,
    loader: 'babel-loader',
    query: {
        compact: false
    }
}

js使用babel来进行加载,这样就可以使用一些es6的特性来开发,IE8下面使用如下方案来进行解决转换后的代码不兼容问题。

==解决IE8 babel 转换:我们把shim.js & sham.js,自己合并到一起吧==

<!--[if IE 8]> <script src='es5-shim-sham.js)'></script><![endif]-->

2)css、less、sass加载器

{
    test: /\.css$/,
    loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues')
}, {
    test: /\.less$/,
    loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues!less-loader')
}, {
    test: /\.scss$/,
    loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues!sass-loader')
}

ExtractTextPlugin是抽离css的插件。css-loader是处理css,会把url(xxx.png)处理成require,然后通过对应后缀名的其他加载器进行处理。==如果是线上环境,css会进行压缩,很多配置要进行调整如果直接采用默认的,转换后的css会出现一些问题==

a)问题一,压缩后字体文件不能处理。解决方法:把iconfont.css里面的注释删除掉即可
b)问题二,压缩后的px单位会转换成pc,pt。解决方法:在加载器里面加上-convertValues参数。
c)问题三,css require的优先级问题,按照常理是后require的css是后加载。但是在实践过程中,(1)通过import引入的js模块中引入的css是优先于require引入的js模块中引入的css;(2)js中require的css名称如果和js所在模块的文件夹名字相同即使部分相同的话,优先级也会提高。

关于css加载器的参数可以参考cssnano。css-loader是根据cssnano对css进行处理的。

3)图片字体文件加载器,file-loader

{
    test: /\.(png|jpg|gif|woff|woff2|ttf|eot|svg)$/,
    loader: "file-loader?name=[name]_[sha512:hash:base64:7].[ext]"
}

对一些图片和字体资源进行加载,我们会把相关文件抽离出来进行名字加上hash值的前7位做了处理后的名字。

4)html加载器

{
    test: /\.html/,
    loader: "html-loader"
}

我们主要把模板文件建成一个Html,然后在Js引入,这样该html就会以字符串格式的值赋给一变量,然后我们用arttemplate进行页面渲染。

脚本文件

  • gulp脚本 gulpfile.js
var gulp = require('gulp'),
    argv = require('yargs').argv,
    fs = require('fs'),
    fse = require('fs-extra'),
    path = require('path'),
    util = require('util');
var webpack = require("webpack"),
    ExtractTextPlugin = require("extract-text-webpack-plugin");

var isWatch = true;
var isProduct = false;
var project = 'iwjw-pc';
//gulp --product
gulp.task('default', function() {
    isProduct = argv.product;
    isWatch = !isProduct;

    console.log('正在处理:' + (isProduct ? '线上' : '本地') + '环境');

    fse.emptydirSync('./dist');

    gulp.start('webpack');
});

//webpack静态处理
gulp.task('webpack', function(callback) {
    var minfy = [];
    isProduct && minfy.push(new webpack.optimize.UglifyJsPlugin({
        compress: {
            warnings: false
        },
        mangle: {
            except: ['$', 'm', 'webpackJsonpCallback']
        }
    }));
    //webpack配置文件
    var config = {
        watch: isWatch,
        entry: {
            index: './index.js',
            common: [
                'jquery',
                'understore',
                'template',
                'store'
            ]
        },
        debug: true,

        devtool: (isProduct ? false : 'source-map'),

        output: {
            path: './dist/',
            filename: '[name].js',
            publicPath: ''
        },

        resolve: {
            alias: {
                jquery: path.resolve('../global/lib/jquery.js'),
                template: path.resolve('../global/lib/template.js'),
                understore: path.resolve('../global/lib/underscore.js'),
                store: path.resolve('../global/lib/store.js')
            }
        },


        plugins: [
            new webpack.ProvidePlugin({
                $: 'jquery',
                jQuery: 'jquery',
                template: 'template',
                store: 'store',
                _: 'understore'
            }),
            new webpack.optimize.DedupePlugin(),
            new ExtractTextPlugin("[name].css"),
            new webpack.optimize.CommonsChunkPlugin('common', 'common.js')
        ].concat(minfy),
        module: {
            loaders: [{
                test: /\.js[x]?$/,
                exclude: /node_modules/,
                loader: 'babel-loader',
                query: {
                    compact: false
                }
            }, {
                test: /\.css$/,
                loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues')
            }, {
                test: /\.less$/,
                loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues!less-loader')
            }, {
                test: /\.scss$/,
                loader: ExtractTextPlugin.extract('style-loader', 'css-loader?-convertValues!sass-loader')
            }, {
                test: /\.(png|jpg|gif|woff|woff2|ttf|eot|svg)$/,
                loader: "file-loader?name=[name]_[sha512:hash:base64:7].[ext]"
            }, {
                test: /\.html/,
                loader: "html-loader"
            }]
        }
    }; 
    webpack(config, function(err, stats) {
        console.log(stats.toString());
    });
});
gulp.task('sham', function(){
    gulp.src('../global/lib/es5-shim-sham.js').pipe(gulp.dest('./dist'));
})
  • pacakge.json
{
  "name": "iwfe",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "start": "node ./bin/server"
  },
  "dependencies": {
    "babel-loader": "^5.3.2",
    "bundle-loader": "^0.5.4",
    "css-loader": "^0.16.0",
    "exports-loader": "^0.6.2",
    "extract-text-webpack-plugin": "^0.8.2",
    "file-loader": "~0.8.4",
    "fs-extra": "*",
    "html-loader": "^0.4.0",
    "imports-loader": "^0.6.5",
    "jquery": "~2.1.4",
    "sass-loader": "^3.1.2",
    "source-map-loader": "^0.1.5",
    "style-loader": "~0.12.3",
    "through2": "*",
    "url-loader": "~0.5.6",
    "webpack": "*",
    "webpack-dev-server": "^1.10.1",
    "yargs": "*",
    "gulp-zip": "*"
  },
  "devDependencies": {
    "gulp": "*",
    "gulp-util": "*"
  },
  "description": "前端静态库",
  "repository": {
    "type": "git",
    "url": "xxx"
  },
  "author": "jade",
  "license": "ISC"
}

参考文档:

webpack github地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容

  • 在现在的前端开发中,前后端分离、模块化开发、版本控制、文件合并与压缩、mock数据等等一些原本后端的思想开始...
    Charlot阅读 5,412评论 1 32
  • 无意中看到zhangwnag大佬分享的webpack教程感觉受益匪浅,特此分享以备自己日后查看,也希望更多的人看到...
    小小字符阅读 8,121评论 7 35
  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 11,018评论 0 21
  • 最近在学习 Webpack,网上大多数入门教程都是基于 Webpack 1.x 版本的,我学习 Webpack 的...
    My_Oh_My阅读 8,150评论 40 247
  • 昨天11月20日比特币价格再创新高,达到了8028美元,即5.3万人民币。看到这个数据,我还是有点小兴奋的,尽管我...
    苏苏日记阅读 170评论 0 0