Webpack 入门教程

webpack是什么本文不再多做赘述,本文主要帮助新手详细的说明使用过程,个人小白的学习过程中遇到的坑尽量填好

后来发现中文文档才是最好的学习地址,很多问题都是出在了webpack的更新上。 请参考:http://webpackdoc.com/troubleshooting.html

安装 Webpack

在安装 Webpack 前,你本地环境需要支持 node.js

由于 npm 安装速度慢,本教程使用了淘宝的镜像及其命令 cnpm,安装使用介绍参照:使用淘宝 NPM 镜像

使用 cnpm 安装 webpack:

cnpm install webpack -g
 

创建项目

接下来我们在命令行里输入指令创建一个目录 app:

mkdir app
 

在 app 目录下添加 runoob1.js 文件,代码如下:

document.write("It works.");

在 app 目录下添加 index.html 文件,代码如下:

 
<html>
    <head>
        <meta charset="utf-8">
    </head>
    <body>
        <script type="text/javascript" src="bundle.js" charset="utf-8"></script>
    </body>
</html>

  接下来我们使用 webpack 命令来打包:(注意,要把终端转移到app文件夹下  cd app)

webpack runoob1.js bundle.js

  执行以上命令会编译 runoob1.js 文件并生成bundle.js 文件,成功后输出信息大概如下所示:

Hash: a41c6217554e666594cb
Version: webpack 1.12.13
Time: 50ms
    Asset     Size  Chunks             Chunk Names
bundle.js  1.42 kB       0  [emitted]  main
   [0] ./runoob1.js 29 bytes {0} [built]

  在浏览器中打开 index.html,输出结果如下:

创建第二个 JS 文件

接下来我们创建另外一个 js 文件 runoob2.js,代码如下所示:

module.exports = "It works from runoob2.js.";

  更新 runoob1.js 文件,代码如下:

document.write(require("./runoob2.js"));

  接下来我们使用 webpack 命令来打包:

 

 

在浏览器访问,输出结果如下所示:

webpack 根据模块的依赖关系进行静态分析,这些文件(模块)会被包含到 bundle.js 文件中。Webpack 会给每个模块分配一个唯一的 id 并通过这个 id 索引和访问模块。 在页面启动时,会先执行 runoob1.js 中的代码,其它模块会在运行 require 的时候再执行。

 

LOADER

Webpack 本身只能处理 JavaScript 模块,如果要处理其他类型的文件,就需要使用 loader 进行转换。

所以如果我们需要在应用中添加 css 文件,就需要使用到 css-loader 和 style-loader,他们做两件不同的事情,css-loader 会遍历 CSS 文件,然后找到 url() 表达式然后处理他们,style-loader 会把原来的 CSS 代码插入页面中的一个 style 标签中。

接下来我们使用以下命令来安装 css-loader 和 style-loader(全局安装需要参数 -g)。

命令行输入:npm install css-loader style-loader

执行以上命令后,会再当前目录生成 node_modules 目录,它就是 css-loader 和 style-loader 的安装目录。

接下来创建一个 style.css 文件,代码如下:

body {
    background: yellow;
}

  修改 runoob1.js 文件,代码如下:

require("!style!css!./style.css"); document.write(require("./runoob2.js"));

require CSS 文件的时候都要写 loader 前缀 !style!css!,当然我们可以根据模块类型(扩展名)来自动绑定需要的 loader。 将 runoob1.js 中的 require("!style!css!./style.css") 修改为 require("./style.css") :

require("!style-loader!css-loader!./style.css") // 载入 style.css
document.write('It works.')
document.write(require('./module.js'))

 重新编译打包,刷新页面,就可以看到黄色的页面背景了。

如果每次 require CSS 文件的时候都要写 loader 前缀,是一件很繁琐的事情。我们可以根据模块类型(扩展名)来自动绑定需要的 loader。

将 entry.js 中的 require("!style!css!./style.css") 修改为 require("./style.css") ,然后执行:

$ webpack entry.js bundle.js --module-bind 'css=style-loader!css-loader'

# 有些环境下可能需要使用双引号
$ webpack entry.js bundle.js --module-bind "css=style-loader!css-loader" 

显然,这两种使用 loader 的方式,效果是一样的。 

配置文件

我们可以将一些编译选项放在配置文件中,以便于统一管理:

创建 webpack.config.js 文件,代码如下所示:

module.exports = {
    entry: "./runoob1.js",
    output: {
        path: __dirname,
        filename: "bundle.js"
    },
    module: {
        loaders: [
//注意webpack2 规定设定module的时候,loader后面要加loader后缀 {test: /\.css$/, loader: 'style-loader!css-loader'} ] } };

  接下来我们只需要执行 webpack 命令即可生成 bundle.js 文件:

Hash: 4fdefac099a5f36ff74b
Version: webpack 1.12.13
Time: 576ms
    Asset     Size  Chunks             Chunk Names
bundle.js  11.8 kB       0  [emitted]  main
   [0] ./runoob1.js 65 bytes {0} [built]
   [5] ./runoob2.js 46 bytes {0} [built]
    + 4 hidden modules

  webpack 命令执行后,会默认载入当前目录的 webpack.config.js 文件

 

插件

插件在 webpack 的配置信息 plugins 选项中指定,用于完成一些 loader 不能完成的工。

webpack 自带一些插件,你可以可以通过 cnpm 安装一些插件。

使用内置插件需要通过以下命令来安装:

cnpm install webpack --save-dev

  比如我们可以安装内置的 BannerPlugin 插件,用于在文件头部输出一些注释信息。

修改 webpack.config.js,代码如下:

var webpack=require('webpack');
 
module.exports = {
    entry: "./runoob1.js",
    output: {
        path: __dirname,
        filename: "bundle.js"
    },
    module: {
        loaders: [
            { test: /\.css$/, loader: "style-loader!css-loader" }
        ]
    },
    plugins:[
    new webpack.BannerPlugin('菜鸟教程 webpack 实例')
    ]
};

  然后运行 webpack,打开 bundle.js,可以看到文件头部出现了我们指定的注释信息。

 

 

Hash: 4fdefac099a5f36ff74bVersion: webpack1.12.13Time: 576msAssetSizeChunksChunkNamesbundle.js11.8kB0[emitted]main[0] ./runoob1.js65bytes{0}[built][5] ./runoob2.js46bytes{0}[built] + 4hiddenmodules

posted @ 2017-03-09 14:29  oldtou  阅读(222)  评论(0编辑  收藏  举报