WebPack 简明学习教程

作者: hutou | 来源:发表于2015-12-28 19:08 被阅读75642次

    WebPack是什么

    1. 一个打包工具
    2. 一个模块加载工具
    3. 各种资源都可以当成模块来处理
    4. 网站 http://webpack.github.io/

    如今,越来越多的JavaScript代码被使用在页面上,我们添加很多的内容在浏览器里。如何去很好的组织这些代码,成为了一个必须要解决的难题。

    对于模块的组织,通常有如下几种方法:

    1. 通过书写在不同文件中,使用script标签进行加载
    2. CommonJS进行加载(NodeJS就使用这种方式)
    3. AMD进行加载(require.js使用这种方式)
    4. ES6模块

    思考:为什么只有JS需要被模块化管理,前台的很多预编译内容,不需要管理吗?

    基于以上的思考,WebPack项目有如下几个目标:

    • 将依赖树拆分,保证按需加载
    • 保证初始加载的速度
    • 所有静态资源可以被模块化
    • 可以整合第三方的库和模块
    • 可以构造大系统

    从下图可以比较清晰的看出WebPack的功能


    这是一个示意图

    WebPack的特点

    1. 丰富的插件,方便进行开发工作
    2. 大量的加载器,包括加载各种静态资源
    3. 代码分割,提供按需加载的能力
    4. 发布工具

    WebPack的优势

    • webpack 是以 commonJS 的形式来书写脚本滴,但对 AMD/CMD 的支持也很全面,方便旧项目进行代码迁移。
    • 能被模块化的不仅仅是 JS 了。
    • 开发便捷,能替代部分 grunt/gulp 的工作,比如打包、压缩混淆、图片转base64等。
    • 扩展性强,插件机制完善,特别是支持 React 热插拔(见 react-hot-loader )的功能让人眼前一亮。

    WebPack的安装

    1. 安装命令
    $ npm install webpack -g
    
    1. 使用webpack
    $ npm init  # 会自动生成一个package.json文件
    $ npm install webpack --save-dev #将webpack增加到package.json文件中
    
    1. 可以使用不同的版本
    $ npm install webpack@1.2.x --save-dev
    
    1. 如果想要安装开发工具
    $ npm install webpack-dev-server --save-dev
    

    WebPack的配置

    每个项目下都必须配置有一个 webpack.config.js ,它的作用如同常规的 gulpfile.js/Gruntfile.js ,就是一个配置项,告诉 webpack 它需要做什么。

    下面是一个例子

    var webpack = require('webpack');
    var commonsPlugin = new webpack.optimize.CommonsChunkPlugin('common.js');
    module.exports = {
        //插件项
        plugins: [commonsPlugin],
        //页面入口文件配置
        entry: {
            index : './src/js/page/index.js'
        },
        //入口文件输出配置
        output: {
            path: 'dist/js/page',
            filename: '[name].js'
        },
        module: {
            //加载器配置
            loaders: [
                { test: /\.css$/, loader: 'style-loader!css-loader' },
                { test: /\.js$/, loader: 'jsx-loader?harmony' },
                { test: /\.scss$/, loader: 'style!css!sass?sourceMap'},
                { test: /\.(png|jpg)$/, loader: 'url-loader?limit=8192'}
            ]
        },
        //其它解决方案配置
        resolve: {
            //查找module的话从这里开始查找
            root: 'E:/github/flux-example/src', //绝对路径
            //自动扩展文件后缀名,意味着我们require模块可以省略不写后缀名
            extensions: ['', '.js', '.json', '.scss'],
            //模块别名定义,方便后续直接引用别名,无须多写长长的地址
            alias: {
                AppStore : 'js/stores/AppStores.js',
                ActionType : 'js/actions/ActionType.js',
                AppAction : 'js/actions/AppAction.js'
            }
        }
    }; 
    
    1. plugins 是插件项,这里我们使用了一个 CommonsChunkPlugin的插件,它用于提取多个入口文件的公共脚本部分,然后生成一个 common.js 来方便多页面之间进行复用。
    2. entry 是页面入口文件配置,output 是对应输出项配置 (即入口文件最终要生成什么名字的文件、存放到哪里)
    3. module.loaders 是最关键的一块配置。它告知 webpack 每一种文件都需要使用什么加载器来处理。 所有加载器需要使用npm来加载
    4. 最后是 resolve 配置,配置查找模块的路径和扩展名和别名(方便书写)

    WebPack开始使用

    这里有最基本的使用方法,给大家一个感性的认识

    1. 正确安装了WebPack,方法可以参考上面
    2. 书写entry.js文件
    document.write("看看如何让它工作!");
    
    1. 书写index.html文件
    <html>
     <head>
     <meta charset="utf-8">
     </head>
     <body>
     <script type="text/javascript" src="bundle.js" charset="utf-8"></script>
     </body>
    </html>
    
    1. 执行命令,生成bundle.js文件
    $ webpack ./entry.js bundle.js
    
    1. 在浏览器中打开index.html文件,可以正常显示出预期
    2. 增加一个content.js文件
    module.exports = "现在的内容是来自于content.js文件!";
    
    1. 修改entry.js文件
    document.write(require("./content.js"));
    
    1. 执行第四步的命令

    进行加载器试验

    1. 增加style.css文件
    body {
     background: yellow;
    }
    
    1. 修改entry.js文件
    require("!style-loader!css-loader!./style.css");
    document.write(require("./content.js"));
    
    1. 执行命令,安装加载器
    $ npm install css-loader style-loader   # 安装的时候不使用 -g
    
    1. 执行webpack命令,运行看效果
    2. 可以在命令行中使用loader
    $ webpack ./entry.js bundle.js --module-bind "css=style-loader!css-loader"
    

    使用配置文件
    默认的配置文件为webpack.config.js

    1. 增加webpack.config.js文件
    module.exports = {
        entry: "./entry.js",
        output: {
            path: __dirname,
            filename: "bundle.js"
        },
        module: {
            loaders: [
                { test: /\.css$/, loader: "style-loader!css-loader" }
            ]
        }
    };
    
    1. 执行程序
    $ webpack
    

    发布服务器

    1. 安装服务器
    $ npm install webpack-dev-server -g
    $ webpack-dev-server --progress --colors
    
    1. 服务器可以自动生成和刷新,修改代码保存后自动更新画面
    http://localhost:8080/webpack-dev-server/bundle
    

    WebPack常用命令

    $ webpack --display-error-details
    

    后面的参数“--display-error-details”是推荐加上的,方便出错时能查阅更详尽的信息(比如 webpack 寻找模块的过程),从而更好定位到问题。

    $ webpack --config XXX.js //使用另一份配置文件(比如webpack.config2.js)来打包
    $ webpack --watch //监听变动并自动打包
    $ webpack -p //压缩混淆脚本,这个非常非常重要!
    $ webpack -d //生成map映射文件,告知哪些模块被最终打包到哪里了 
    

    相关文章

      网友评论

      • 9bd74219c762:写的挺不错的,已经收藏了。

        源码解析:http://suo.im/1FKU2k


        aec055493426:源码解析还不错

        加油!
      • L楠:您好,请问webpack.config.js是自己新建的吗?
        hutou: @L楠 是的
      • 帅成一道风景:webpack时出现
        Module not found: Error: Can't resolve 'fs' 怎么解决
      • 82c7d8841fc7:没人爆这个错误么:
        bundle.js:57 Uncaught ReferenceError: Vue is not defined
      • 82c7d8841fc7:没有挂在到.html文件上面 怎么跑 博主可否能指点下
      • 82c7d8841fc7:没明白 博主是怎么跑起来的 之后改咋办
        82c7d8841fc7:webpack --config webpack.config.js
      • 海上钢琴师TD1900:有毒,$ webpack ./entry.js bundle.js这一步根本就不行,全是报错
      • 585b1bdbf8a6:css加载错误? require("!style!css!./style.css");// 有点问题,报错
        hutou:我试验了一下,确实有点问题,可能是版本的关系!改成:require("!style-loader!css-loader!./style.css");
      • 非魚_13dc:require那块是不是应改成style-loader css-loader?
      • 后知不觉1:插件是怎么使用的那?好像只是声明要用这个插件
      • 04b265da0b71:ERROR in ./entry.js
        Module not found: Error: Can't resolve 'style' in '/Users/renyunlong/workspace/learnWebpack'
        BREAKING CHANGE: It's no longer allowed to omit the '-loader' suffix when using loaders.
        You need to specify 'style-loader' instead of 'style'.
        @ ./entry.js 5:0-33
        请问这个怎么改?
        6908a90d27b8:require("!style-loader!css-loader!./style.css");
        db38accb7698:style 修改成为 style-loader 其实就是每个 loaders 都需要增加 -loader --------------------割--------------------- !是相当于分号的意思 ,so css-loader ! style-loader ! sass-loader 为了阅读方便 感叹号两边增加了空格
      • 泡泡_芙:按照你的步骤来的 但不能实现自动刷新页面 必须要webpack ./entry.js bundle.js
      • e735454ffe36:请教一下如何压缩多个js文件?如将a.js,b.js,c.js压缩成d.js
        madisoon:@力嘉 可以配套使用gulp,比较好的解决方案
      • ca301cc75758:这篇文章对webpack的讲解,个人感觉有出入。首先,webpack命令,在使用的时候,不应webpack ./entry.js bundle.js,本已经在webpack.config.js的entry指定了入口js文件,再在调用webpack命令时指定要打包的js文件,这本身是错误的。有不同意见的可以提出来探讨下。
        ca301cc75758:@ca301cc75758 此外,引入打包后的js时,还要先引入,注意是先引入,你生成的common.js。
      • 陈小跑:写得很好,666
      • a8bd80504a38:@兼职
        非常不错,一步步操作完全没问题,谢谢了
      • 620df469997c:厉害!欣赏对技术自信的你!
      • af0e48c9d233:楼主真棒~
      • 萝卜粥_Carrot:非常棒的入门教程,谢谢!
      • Angelet:给你一个赞
      • 祚鹤:简明扼要,赞 :+1:
      • CoderYan: 0% compilehttp://localhost:8080/webpack-dev-server/
        webpack result is served from /
        content is served from C:\Users\Yan\Desktop\WorkSpace\webpack
        之后就跳出来,请问是什么原因呢?
      • CoderYan:请问webpack-dev-server --progress --colors这个命令执行是不是要在工程目录下执行?
        天晴有太阳:@JavaPlayer 是的
      • 一直喜欢一个人:棒棒的!!!!

      本文标题:WebPack 简明学习教程

      本文链接:https://www.haomeiwen.com/subject/pwrvhttx.html