手摸手 Webpack 多入口配置实践

时间  2019-11-05
标签 webpack 入口 配置 实践 繁體版
原文   原文链接

最近在作项目的时候遇到了一个场景：一个项目有多个入口，不一样的入口，路由、组件、资源等有重叠部分，也有各自不一样的部分。因为不一样入口下的路由页面有一些是重复的，所以我考虑使用 Webpack 多入口配置来解决这个需求。javascript

再一次，在网上找的很多文章都不合个人需求，不少文章都是只简单介绍了生产环境下配置，没有介绍开发环境下的配置，有的也没有将多入口结合 vue-router、vuex、ElementUI 等进行配置，所以在下经过不断探坑，而后将思路和配置过程记录下来，留给本身做为笔记，同时也分享给你们，但愿能够帮助到有一样需求的同窗们～html

1. 目标分析

  1. 一个项目中保存了多个 HTML 模版，不一样的模版有不一样的入口，而且有各自的 router、store 等；
  2. 不只能够打包出不一样 HTML，并且开发的时候也能够顺利进行调试；
  3. 不一样入口的文件能够引用同一份组件、图片等资源，也能够引用不一样的资源；

代码仓库：multi-entry-vue前端

示意图以下：vue

2. 准备工做

首先咱们 vue init webpack multi-entry-vue 使用 vue-cli 建立一个 webpack 模版的项。文件结构以下：java

.
├── build
├── config
├── src
│   ├── assets
│   │   └── logo.png
│   ├── components
│   │   └── HelloWorld.vue
│   ├── router
│   │   └── index.js
│   ├── App.vue
│   └── main.js 
├── static
├── README.md
├── index.html
├── package-lock.json
└── package.json
复制代码

这里顺便介绍在不一样系统下生成目录树的方法：node

  1. mac 系统命令行生成目录树的方法 tree -I node_modules --dirsfirst ，这个命令的意思是，不显示 node_modules 路径的文件，而且以文件夹在前的排序方式生成目录树。若是报没有找到 tree 命令的错，安装 tree 命令行 brew install tree 便可。
  2. windows 系统在目标目录下使用 tree /f 1.txt 便可把当前目录树生成到一个新文件 1.txt 中。

首先咱们简单介绍一下 Webpack 的相关配置项，这些配置项根据使用的 Webpack 模版不一样，通常存放在 webpack.config.js 或 webpack.base.conf.js 中：webpack

const path = require('path')
module.exports = {
  context: path.resolve(__dirname, '../'),
  entry: {
    app: './src/main.js'
  },
  output: {
    path: path.resolve(__dirname, '../dist'),
    filename: 'output-file.js',
    publicPath: '/'
  },
  module: {},        // 文件的解析 loader 配置
  plugins: [],       // 插件，根据须要配置各类插件
  devServer: {}      // 配置 dev 服务功能
}
复制代码

这个配置的意思是，进行 Webpack 后，会在命令的执行目录下新建 dist 目录（若是须要的话），并将打包 src 目录下的 main.js 和它的依赖，生成 output-file.js 放在 dist 目录中。git

下面稍微解释一下相关配置项：github

  1. entry： 入口文件配置项，能够为字符串、对象、数组。 以上面的对象形式为例，app 是入口名称，若是 output.filename 中有 [name] 的话，就会被替换成 app。
  2. context： 是 webpack 编译时的基础目录，用于解析 entry 选项的基础目录(绝对路径)，entry 入口起点会相对于此目录查找，至关于公共目录，下面全部的目录都在这个公共目录下面。
  3. output： 出口文件的配置项。
  4. output/path： 打包文件输出的目录，好比上面的 dist，那么就会将输出的文件放在当前目录同级目录的 dist 文件夹下，没有这个文件夹就新建一个。 能够配置为 path.resolve(__dirname, './dist/${Date.now()}/') （md 语法不方便改为模板字符串，请自行修改）方便作持续集成。
  5. output.filename： 输出的文件名称，[name] 的意为根据入口文件的名称，打包成相同的名称，有几个入口，就能够打包出几个文件。 好比入口的 key 为 app，打包出来就是 app.js，入口是 my-entry，打包出来就是 my-entry.js。
  6. output.publicPath： 静态资源的公共路径，能够记住这个公式： 静态资源最终访问路径 = output.publicPath + 资源loader或插件等配置路径。 举个例子，publicPath 配置为 /dist/，图片的 url-loader 配置项为 name: 'img/[name].[ext]' ，那么最终打包出来文件中图片的引用路径为 output.publicPath + 'img/[name].[ext]' = '/dist/img/[name].[ext]'。

本文因为是入口和出口相关的配置，因此内容主要围绕着 entry 、output 和一个重要的 webpack 插件 html-webpack-plugin，这个插件是跟打包出来的 HTML 文件密切相关，主要有下面几个做用：web

  1. 根据模版生成 HTML 文件；
  2. 给生成的 HTML 文件引入外部资源好比 link、script 等；
  3. 改变每次引入的外部文件的 Hash，防止 HTML 引用缓存中的过期资源；

下面咱们从头一步步配置一个多入口项目。

3. 开始配置

3.1 文件结构改动

在 src 目录下将 main.js 和 App.vue 两个文件各复制一下，做为不一样入口，文件结构变为：

.
├── build
│   ├── build.js
│   ├── check-versions.js
│   ├── logo.png
│   ├── utils.js
│   ├── vue-loader.conf.js
│   ├── webpack.base.conf.js
│   ├── webpack.dev.conf.js    # 主要配置目标
│   └── webpack.prod.conf.js   # 主要配置目标
├── config
│   ├── dev.env.js
│   ├── index.js
│   └── prod.env.js
├── src
│   ├── assets
│   │   └── logo.png
│   ├── components
│   │   └── HelloWorld.vue
│   ├── router
│   │   └── index.js
│   ├── App.vue
│   ├── App2.vue       # 新增的入口
│   ├── main.js
│   └── main2.js       # 新增的入口
├── static
├── README.md
├── index.html
└── package.json
复制代码

3.2 简单配置

要想从不一样入口，打包出不一样 HTML，咱们能够改变一下 entry 和 output 两个配置，

// build/webpack.prod.conf.js

module.exports = {
  entry: {
    entry1: './src/main.js',
    entry2: './src/main2.js'
  },
  output: {
    filename: '[name].js',
    publicPath: '/'
  },
    plugins: [
        new HtmlWebpackPlugin({
            template: "index.html",  // 要打包输出哪一个文件，可使用相对路径
            filename: "index.html"   // 打包输出后该html文件的名称
        })
    ]
}
复制代码

根据上面一小节咱们知道，webpack 配置里的 output.filename 若是有 [name] 意为根据入口文件的名称，打包成对应名称的 JS 文件，那么如今咱们是能够根据两个入口打包出 entry.js 和 entry2.js。

打包的结果以下：

当前代码：Github - multi-entry-vue1

如上图，此时咱们 npm run build 打包出一个引用了这两个文件的 index.html，那么如何打包出不一样 HTML 文件，分别应用不一样入口 JS 文件呢，此时咱们须要借助于 HtmlWebpackPlugin 这个插件。

HtmlWebpackPlugin 这个插件，new 一个，就打包一个 HTML 页面，因此咱们在 plugins 配置里 new 两个，就能打包出两个页面来。

3.3 打包出不一样的 HTML 页面

咱们把配置文件改为下面这样：

// build/webpack.prod.conf.js

module.exports = {
  entry: {
    entry: './src/main.js',   // 打包输出的chunk名为entry
    entry2: './src/main2.js'  // 打包输出的chunk名为entry2
  },
  output: {
    filename: '[name].js',
    publicPath: '/'
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: 'entry.html',  // 要打包输出的文件名
      template: 'index.html',  // 打包输出后该html文件的名称
      chunks: ['manifest', 'vendor', 'entry']  // 输出的html文件引入的入口chunk
      // 还有一些其余配置好比minify、chunksSortMode和本文无关就省略，详见github
    }),
    new HtmlWebpackPlugin({
      filename: 'entry2.html',
      template: 'index.html',
      chunks: ['manifest', 'vendor', 'entry2']
    })
  ]
}
复制代码

上面一个配置要注意的是 chunks，若是没有配置，那么生成的 HTML 会引入全部入口 JS 文件，在上面的例子就是，生成的两个 HTML 文件都会引入 entry.js 和 entry2.js，因此要使用 chunks 配置来指定生成的 HTML 文件应该引入哪一个 JS 文件。配置了 chunks 以后，才能达到不一样的 HTML 只引入对应 chunks 的 JS 文件的目的。

你们能够看到除了咱们打包生成的 chunk 文件 entry.js 和 entry2.js 以外，还有 manifest 和 vendor 这两个，这里稍微解释一下这两个 chunk：

  1. vendor 是指提取涉及 node_modules 中的公共模块；
  2. manifest 是对 vendor 模块作的缓存；

打包完的结果以下：

文件结构：

如今打包出来的样式正是咱们所须要的，此时咱们在 dist 目录下启动 live-server（若是你没安装的话能够先安装 npm i -g live-server），就能够看到效果出来了：

当前代码：Github - multi-entry-vue2

至此就实现了一个简单的多入口项目的配置。

4. 配置改进

4.1 文件结构改动

咱们在前文进行了多入口的配置，要想新建一个新的入口，就复制多个文件，再手动改一下对应配置。

可是若是不一样的 HTML 文件下不一样的 vue-router、vuex 都放到 src 目录下，多个入口的内容平铺在一块儿，项目目录会变得凌乱不清晰，所以在下将多入口相关的文件放到一个单独的文件夹中，之后若是有多入口的内容，就到这个文件夹中处理。

下面咱们进行文件结构的改造：

  1. 首先咱们在根目录建立一个 entries 文件夹，把不一样入口的 router、store、main.js 都放这里，每一个入口相关单独放在一个文件夹；
  2. 在 src 目录下创建一个 common 文件夹，用来存放多入口共用的组件等；

如今的目录结构：

.
├── build    # 没有改动
├── config   # 没有改动
├── entries  # 存放不一样入口的文件
│   ├── entry1
│   │   ├── router       # entry1 的 router
│   │   │   └── index.js
│   │   ├── store        # entry1 的 store
│   │   │   └── index.js
│   │   ├── App.vue      # entry1 的根组件
│   │   ├── index.html   # entry1 的页面模版
│   │   └── main.js      # entry1 的入口
│   └── entry2
│       ├── router
│       │   └── index.js
│       ├── store
│       │   └── index.js
│       ├── App.vue
│       ├── index.html
│       └── main.js
├── src
│   ├── assets
│   │   └── logo.png
│   ├── common          # 多入口通用组件
│   │   └── CommonTemplate.vue
│   └── components
│       ├── HelloWorld.vue
│       ├── test1.vue
│       └── test2.vue
├── static
├── README.md
├── index.html
├── package-lock.json
└── package.json
复制代码

4.2 webpack 配置

而后咱们在 build/utils 文件中加两个函数，分别用来生成 webpack 的 entry 配置和 HtmlWebpackPlugin 插件配置，因为要使用 node.js 来读取文件夹结构，所以须要引入 fs、glob 等模块：

// build/utils
const fs = require('fs')
const glob = require('glob')
const merge = require('webpack-merge')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const ENTRY_PATH = path.resolve(__dirname, '../entries')

// 多入口配置，这个函数从 entries 文件夹中读取入口文件，装配成webpack.entry配置
exports.entries = function() {
  const entryFiles = glob.sync(ENTRY_PATH + '/*/*.js')
  const map = {}
  entryFiles.forEach(filePath => {
    const filename = filePath.replace(/.*\/(\w+)\/\w+(\.html|\.js)$/, (rs, $1) => $1)
    map[filename] = filePath
  })
  return map
}

// 多页面输出模版配置 HtmlWebpackPlugin，根据环境装配html模版配置
exports.htmlPlugin = function() {
  let entryHtml = glob.sync(ENTRY_PATH + '/*/*.html')
  let arr = []
  entryHtml.forEach(filePath => {
    let filename = filePath.replace(/.*\/(\w+)\/\w+(\.html|\.js)$/, (rs, $1) => $1)
    let conf = {
      template: filePath,
      filename: filename + '.html',
      chunks: [filename],
      inject: true
    }
    
    // production 生产模式下配置
    if (process.env.NODE_ENV === 'production') {
      conf = merge(conf, {
        chunks: ['manifest', 'vendor'],
        minify: {
          removeComments: true,
          collapseWhitespace: true,
          removeAttributeQuotes: true
        },
        chunksSortMode: 'dependency'
      })
    }
    arr.push(new HtmlWebpackPlugin(conf))
  })
  return arr
}
复制代码

稍微解释一下这两个函数：

  1. exports.entries 函数从 entries 文件夹中找到二级目录下的 JS 文件做为入口文件，而且将二级目录的文件夹名做为 key，生成这样一个对象：{"entry1": "/multi-entry-vue/entries/entry1/main.js"}，多个入口状况下会有更多键值对；

  2. exports.htmlPlugin 函数和以前函数的原理相似，不过组装的是 HtmlWebpackPlugin 插件的配置，生成这样一个数组，能够看到和咱们手动设置的配置基本同样，只不过如今是根据文件夹结构来生成的：

    // production 下
[
  {
    template: "/multi-entry-vue/entries/entry1/index.html",
    chunks: ['manifest', 'vendor', 'entry1'],
    filename: "entry1.html",
    chunksSortMode: 'dependency'
  },
  { ... }   // 下一个入口的配置
]
复制代码

有了这两个根据 entries 文件夹的结构来自动生成 webpack 配置的函数，下面来改一下 webpack 相关的几个配置文件：

// build/webpack.base.conf.js

module.exports = {
  entry: utils.entries(),   // 使用函数生成 entry 配置
  output: {
    path: config.build.assetsRoot,
    filename: '[name].js',
    publicPath: process.env.NODE_ENV === 'production'
      ? config.build.assetsPublicPath
      : config.dev.assetsPublicPath
  }
}
复制代码
// build/webpack.dev.conf.js

// const HtmlWebpackPlugin = require('html-webpack-plugin') // 不须要了

const devWebpackConfig = merge(baseWebpackConfig, {
  devServer: {
    historyApiFallback: {
      rewrites: [        // 别忘了把 devserver 的默认路由改一下
        { from: /.*/, to: path.posix.join(config.dev.assetsPublicPath, 'entry1.html') },
      ],
    }
  },
  plugins: [
    // https://github.com/ampedandwired/html-webpack-plugin
    // new HtmlWebpackPlugin({
    // filename: 'index.html',
    // template: 'index.html',
    // inject: true
    // }), // 注释掉原来的 HtmlWebpackPlugin 配置，使用生成的配置
  ].concat(utils.htmlPlugin())
})
复制代码
// build/webpack.prod.conf.js

// const HtmlWebpackPlugin = require('html-webpack-plugin')

const webpackConfig = merge(baseWebpackConfig, {
  plugins: [
    // new HtmlWebpackPlugin({
    // ... 注释掉，不须要了
    // }),
  ].concat(utils.htmlPlugin())
})
复制代码

如今咱们再 npm run build，看看生成的目录是什么样的：

此时咱们在 dist 目录下启动 live-server 看看是什么效果：

当前代码：Github - multi-entry-vue3

网上的帖子大多深浅不一，甚至有些先后矛盾，在下的文章都是学习过程当中的总结，若是发现错误，欢迎留言指出~

参考：

  1. webpack解惑：多入口文件打包策略
  2. webpack配置文件：入口和出口，多入口、多出口配置
  3. 一看就懂之webpack高级配置与优化

PS：欢迎你们关注个人公众号【前端下午茶】，一块儿加油吧~

另外能够加入「前端下午茶交流群」微信群，长按识别下面二维码便可加我好友，备注加群，我拉你入群～

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程