CLI

 

如果你使用CLI ，webpack 会默认读取webpack.config.js（或者通过 --config 选项指向读取文件），该文件需要导出一个配置对象。

 

module.exports = {

 

    // configuration

 

};

 

node.js API

 

如果使用node.js API 需要将配置对象当作参数传递:

 

webpack({

 

    // configuration

 

}, callback);

 

多个配置对象

 

在这两种方法里面，你都可以使用一个配置对象数组来并行的执行。 他们共享数据缓存，和监听器，这样比多次执行webpack效率更高。

 

配置对象内容

 

提示: 记住不要拘泥于在配置对象里面写纯json对象，可以使用你想使用的任何js方法，他仅仅是一个nodejs模块罢了。

 

简单的例子:

 

{

 

    context: __dirname + "/app",

 

    entry: "./entry",

 

    output: {

 

        path: __dirname + "/dist",

 

        filename: "bundle.js"

 

    }

 

}

 

context

 

用于解析entry选项的基础目录(绝对路径), 如果output.pathinfo设置了，就包含了缩短过的目录；（相当于公共目录，下面所有的目录都在这个公共目录下面)

 

默认: process.cwd()

 

entry

 

bundle的入口点。

 

如果传入一个字符串，这个字符串就会被解析为启动时加载的模块。

 

如果传入个数组，所有模块都是启动时加载，模块导出到最后一个里面。

 

entry: ["./entry1", "./entry2"]

 

如果传入一个对象，就会创建多个输入包文件，对象键值就chunk的name，值可以是字符串或者是数组。

 

{

 

  entry: {

 

      page1: "./page1",

 

      page2: ["./entry1", "./entry2"]

 

  },

 

  output: {

 

      // 当使用多入口文件时候，要确保在output.filename使用[name]或者[id]

 

      filename: "[name].bundle.js",

 

      chunkFilename: "[id].bundle.js"

 

  }

 

}

 

注意: 没有别的专门来配置入口点的选项。如果你需要一个专门来配置入口点的配置对象，你需要用到多个配置对象.

 

output

 

output是影响编译输出的选项。output选项告诉webpack怎么把编译文件写入磁盘。注意，虽然可以有很多输入口，但是只有一个输出配置

 

如果使用了哈希([hash] 或者 [chunkhash]), 需要确保有一个一致的模块顺序。使用OccurenceOrderPlugin插件或者 recordsPath。(译者：参看这个issue)

 

output.filename

 

指定输出到硬盘的文件的的文件名。这里不能是一个绝对的路径！output.path会确定该文件的存在硬盘额路径的。filename仅仅用来给每个文件命名而已。