加载中...

入口起点(Entry Points)

正如我们在起步中提到的，在 webpack 配置中有多种方式定义 entry 属性。除了解释为什么它可能的用途，我们还将向你展示如何去配置 entry 属性。

单个入口（简写）语法

用法：entry: string|Array<string>

webpack.config.js 

const config = {
  entry: './path/to/my/entry/file.js'
};

module.exports = config;

entry 属性的单个入口语法，是下面的简写： 

const config = {
  entry: {
    main: './path/to/my/entry/file.js'
  }
};

T> 当你向 entry 传入一个数组时会发生什么？向 entry 属性传入「文件路径(file path)数组」将创建“多个主入口(multi-main entry)”。传入数组这种方式有助于，在你想要多个依赖文件一起注入，并且将它们的依赖导向(graph)到一个“chunk”时。

当你正在寻找为「一个应用程序或只有一个入口起点的工具（即 library）」快速设置一个 webpack 配置的时候，这会是个很不错的选择。但是，使用此语法扩展(extend or scale)配置没有太多的灵活性。

对象语法

用法：entry: {[entryChunkName: string]: string|Array<string>}

webpack.config.js 

const config = {
  entry: {
    app: './src/app.js',
    vendors: './src/vendors.js'
  }
};

对象语法会比较繁琐。然而，这是应用程序中定义入口的最可扩展的方式。

T> “可扩展的 webpack 配置”是指，可重用并且可以与其他配置组合使用。这是一种流行的技术，用于将关注点(concern)从环境(environment)、构建目标(build target)、运行时(runtime)中分离。然后使用专门的工具（如 webpack-merge）将它们合并。

常见场景

以下列出入口配置和它们的实际用例：

分离 应用程序(app) 和 公共库(vendor) 入口

webpack.config.js 

const config = {
  entry: {
    app: './src/app.js',
    vendors: './src/vendors.js'
  }
};

是什么？从表面上看，这告诉我们 webpack 从 app.js 和 vendors.js 开始创建依赖图表(dependency graph)。这些图表是彼此完全分离、互相独立的（每个 bundle 中都有一个 webpack 引导(bootstrap)）。这种方式比较常见于，只有一个入口起点（不包括 vendor）的单页应用程序(single page application)中。

为什么？此设置允许你使用 CommonsChunkPlugin 从「应用程序 bundle」中提取 vendor 引用(vendor reference) 到 vendor bundle，并把 vendor 引用的部分替换为 __webpack_require__() 调用。如果应用程序 bundle 中没有 vendor 代码，那么你可以在 webpack 中实现被称为长效缓存的通用模式。

» Consider removing this scenario in favor of the DllPlugin, which provides a better vendor-splitting.

多个页面应用程序

webpack.config.js 

const config = {
  entry: {
    pageOne: './src/pageOne/index.js',
    pageTwo: './src/pageTwo/index.js',
    pageThree: './src/pageThree/index.js'
  }
};

是什么？我们告诉 webpack 需要 3 个独立分离的依赖图表（如上面的示例）。

为什么？在多页应用中，服务器将为你获取一个新的 HTML 文档。页面重新加载新文档，并且资源被重新下载。然而，这给了我们特殊的机会去做很多事：

  • 使用 CommonsChunkPlugin 为每个页面间的应用程序共享代码创建 bundle。由于入口起点增多，多页应用能够在入口起点重用大量代码/模块，这样可以极大的从这些这些技术受益。

T> 根据经验：每个 HTML 文档只使用一个入口起点。

原文：https://webpack.js.org/concepts/entry-points/

还没有评论.