Entry
entry 是配置模块的入口,可抽象成输入,Webpack 执行构建的第一步将从入口开始搜寻及递归解析出所有入口依赖的模块。
entry 配置是必填的,若不填则将导致 Webpack 报错退出。
context
Webpack 在寻找相对路径的文件时会以 context
为根目录,context
默认为执行启动 Webpack 时所在的当前工作目录。 如果想改变 context
的默认配置,则可以在配置文件里这样设置它:
1 module.exports = { 2 context: path.resolve(__dirname, 'app') 3 }
注意, context
必须是一个绝对路径的字符串。 除此之外,还可以通过在启动 Webpack 时带上参数 webpack --context
来设置 context
。
之所以在这里先介绍 context
,是因为 Entry 的路径和其依赖的模块的路径可能采用相对于 context
的路径来描述,context
会影响到这些相对路径所指向的真实文件。
Entry 类型
Entry 类型可以是以下三种中的一种或者相互组合:
类型 | 例子 | 含义 |
---|---|---|
string | './app/entry' |
入口模块的文件路径,可以是相对路径。 |
array | ['./app/entry1', './app/entry2'] |
入口模块的文件路径,可以是相对路径。 |
object | { a: './app/entry-a', b: ['./app/entry-b1', './app/entry-b2']} |
配置多个入口,每个入口生成一个 Chunk |
如果是 array 类型,则搭配 output.library 配置项使用时,只有数组里的最后一个入口文件的模块会被导出。
Chunk 名称
Webpack 会为每个生成的 Chunk 取一个名称,Chunk 的名称和 Entry 的配置有关:
- 如果
entry
是一个 string 或 array ,就只会生成一个 Chunk,这时 Chunk 的名称是 main ; - 如果
entry
是一个 object ,就可能会出现多个 Chunk,这时 Chunk 的名称是 object 键值对里键的名称。
配置动态 Entry
假如项目里有多个页面需要为每个页面的入口配置一个 Entry ,但这些页面的数量可能会不断增长,则这时 Entry 的配置会受到到其他因素的影响导致不能写成静态的值。其解决方法是把 Entry 设置成一个函数去动态返回上面所说的配置,代码如下:
1 // 同步函数 2 entry: () => { 3 return { 4 a:'./pages/a', 5 b:'./pages/b', 6 } 7 }; 8 // 异步函数 9 entry: () => { 10 return new Promise((resolve)=>{ 11 resolve({ 12 a:'./pages/a', 13 b:'./pages/b', 14 }); 15 }); 16 };