# 构建工具

前端打包构建主要用 webpack。下面分别介绍一下手配过程中的一些关键点。 webpack5 简化了很多配置,但是还没有正式发版,本文还是基于 webpack4 来配置。

# webpack

# 打包脚本配置

正常打包脚本配置在 package.json 的 scripts 属性内。当脚本变多时,将会变得"又丑又长"。如何使打包的脚本变得更加简洁强大? 这里要使用两个库,一个是scripty。scripty 会找到项目根目录 /scripts/目录下的 shell 文件,执行相应的命令。通过它可以简化 scripts 配置,同时让脚本可以执行 shell 命令,也可以做更多事情。还有一个库是npm-run-allnpm-run-all顾名思义,可以让我们串行或者并行执行 npm 命令。一个项目的通用配置可以如下:

//package.json
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "client:dev": "scripty",
    "client:devServer": "scripty",
    "client:prod": "scripty",
    "server:dev": "scripty",
    "server:start": "scripty",
    "build": "npm-run-all --parallel client:prod server:prod",
    "build:dev":"npm-run-all --parallel client:dev server:dev"
  },

1
2
3
4
5
6
7
8
9
10
11
12

# 分离 webpack.config 为 dev 和 prod

dev 开发环境时,我们为了让打包更快,会省略掉一些压缩合并的操作。但是在生产环境,我们是需要压缩合并的。因此要做 config 分离。 这里用到的库是webpack-merge

例:

//webpack.config.js
const { merge } = require("webpack-merge");

const argv = require("yargs-parser")(process.argv.slice(2));
const _mode = argv.mode || "development";
const _modeflag = _mode === "production" ? true : false;
//找到对应环境的webpack.config.js文件
const _mergeConfig = require(`./config/webpack.${_mode}.js`);
//...

module.exports = merge(webpackConfig, _mergeConfig);
1
2
3
4
5
6
7
8
9
10
11

# 多环境打包

webpack 默认只能打 development 和 production 两种环境的包,在实际开发过程中我们可能还需要打出测试环境的包,或者别的自定义环境的包。要实现这个功能,需要用到 webpack 的 DefinePlugin 插件,再配合 cross-env 实现。

首先在 webpack.config.js 中配置打包的插件。这个插件可以在编译时将 process.env.NODE_ENV 动态替换为我们定义的变量。

//webpack.config.js
const webpack = require("webpack");

...

module.exports = {
  plugins:[
    new webpack.DefinePlugin({
      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV)
    }),
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12

然后,配置打包脚本

//开发环境
  cross-env NODE_ENV=development webpack
//测试环境
  cross-env NODE_ENV=test webpack

1
2
3
4
5

# 自定义插件

项目使用的模板引擎是 koa-swig 模板引擎。正常使用 html-webpack-plugin 打包之后,js 插入的位置如下:

{% extends '@layouts/layout.html' %} 
{% block title %} 首页 {%endblock%} 
{% block head %} {% endblock %} 
{% block content %} {% include "@components/home/home.html" %} {% endblock %} 
{% block scripts %}{% endblock %}
<script src="/scripts/runtime.bundle.js"></script><script src="/scripts/index-home.bundle.js"></script>

1
2
3
4
5
6
7

很明显,js插入的位置错误了,本来应该放在block scripts标签里面的,现在插入到了最后。为了解决这个问题,需要在webpack编译的过程动态的替换掉注入的css和js。

解决步骤:

  1. 在模板中定义魔法字符串
{% extends '@layouts/layout.html' %} 

{% block title %} 首页 {%endblock%} 
{% block head %}
<!--injectcss-->
{% endblock %} 
{% block content %} 
{% include "@components/home/home.html" %}

{% endblock %} 

{% block scripts %}
<!--injectjs-->
{% endblock %}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<!--injectcss--><!--injectjs-->是我们定义的魔法字符串,用于后面动态替换。

  1. 设置html-webpack-plugin不注入css和js
    _plugins.push(
      new HtmlWebpackPlugin({
        filename: `../views/${dist}/pages/${template}.html`,
        template: `src/web/views/${dist}/pages/${template}.html`,
        chunks: ['runtime', entryKey],
        inject: false,//放弃自动插入css js,因为自动插入位置不对
        minify: {
          removeComments: false,
          collapseWhitespace: true,
        },
      })

1
2
3
4
5
6
7
8
9
10
11
12
  1. 自定义打包插件HtmlAfterPlugin 首先来看下html-webpack-plugin给我们提供的勾子 '
  • beforeAssetTagGeneration 。走到这个勾子html-webpack-plugin已经为我们编译好了模板,并且把资源文件 js和css找到了
  • alterAssetTags。 到这个勾子,已经创建好了script 样式和meta标签。
  • alterAssetTagGroups。到这个勾子,已经将所有的标签按插入的位置分好组。
  • afterTemplateExecution。到这个勾子,提交分组标签,执行完模板编译。
  • beforeEmit。到这个勾子,已经生成html,并插入了js、css等标签。
  • afterEmit。将生成的文件保存到本地。

由于我们禁用了webpack的自动inject。因此步骤5、6、10不会执行。我们只需要在beforeAssetTagGeneration后将找到的js css保存下来,在berforeEmit的时候动态插入到生产的html中。这个插件实现如下:

const HtmlWebpackPlugin = require('html-webpack-plugin');
const pluginName = 'HtmlAfterPlugin';

const assetsHelp = (data) => {
  const js = [];
  const css = [];
  const getAssetsName = {
    css: (item) => `<link rel="stylesheet" href="${item}">`,
    js: (item) => `<script class="lazyload-js" src="${item}"></script>`,
  };
  for (let jsitem of data.js) {
    js.push(getAssetsName.js(jsitem));
  }
  for (let cssitem of data.css) {
    css.push(getAssetsName.css(cssitem));
  }
  return {
    js,
    css,
  };
};

class HtmlAfterPlugin {
  constructor() {
    this.jsarr = [];
    this.cssarr = [];
  }
  apply(compiler) {
    compiler.hooks.compilation.tap(pluginName, (compilation) => {
      HtmlWebpackPlugin.getHooks(compilation).beforeAssetTagGeneration.tapAsync(
        pluginName,
        (htmlPligunData, cb) => {
          const { js, css } = assetsHelp(htmlPligunData.assets);
          this.cssarr = css;
          this.jsarr = js;
          cb(null, htmlPligunData);
        }
      );
      HtmlWebpackPlugin.getHooks(compilation).beforeEmit.tapAsync(
        pluginName,
        (data, cb) => {
          let _html = data.html;
          _html = _html.replace('<!--injectjs-->', this.jsarr.join(''));
          _html = _html.replace('<!--injectcss-->', this.cssarr.join(''));
          _html = _html.replace(/@components/g, '../../../components');
          _html = _html.replace(/@layouts/g, '../../layouts');
          data.html = _html;
          cb(null, data);
        }
      );
    });
  }
}

module.exports = HtmlAfterPlugin;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
  1. 在webpack中配置plugin
  //webpack.config.js
  plugins:[
    new HtmlWebpackPlugin(),

    ...

    //放在HtmlWebpackPlugin的后面
    new HtmlAfterPlugin(),

  ]
1
2
3
4
5
6
7
8
9
10

# webpack打包Node端

做react isomorphic的时候,需要用到webpack为我们生成Node端的代码。打node端代码时有几个特别注意的点:

  1. target设置 target一定要设置为node端。
//webpack.server.js

  module.exports = {
      target: "node",
  }

1
2
3
4
5
6
  1. 如果打包的组件,要设置libraryTarget
  module.exports = {
    output: {
      path: path.resolve(__dirname, "dist/"),
      filename: "server.bundle.js",
      libraryTarget: "umd",
    },
  }

1
2
3
4
5
6
7
8
  1. 如果使用了__dirname需要配置node选项,避免路径问题
  module.exports = {
    node: {
      __dirname: false,
      __filename: false
    },
  }

1
2
3
4
5
6
7

我的一份完整的配置

// webpack.server.js
const path = require("path");
const merge = require("webpack-merge");
const nodeExternals = require("webpack-node-externals");
const TerserPlugin = require("terser-webpack-plugin");
const { join, resolve } = require("path");
const postcssNormalize = require('postcss-normalize');
const webpack = require("webpack");

const serverConfig = {
  target: "node",
  entry: path.resolve("./src/server/app.js"),
  output: {
    path: path.resolve(__dirname, "dist/"),
    filename: "server.bundle.js",
    libraryTarget: "umd",
  },
  plugins:[
    new webpack.DefinePlugin({
      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV)
    })
  ],
  module: {
    rules: [
      {
        test: /\.(png|jpg|gif|svg)$/,
        use: [
          {
            loader: "url-loader",
          },
        ],
      },
      {
        test: /\.css$/,
        use: [
          {
            loader: "css-loader",
            options: {
              importLoaders: 1,
            },
          },
          {
            // Options for PostCSS as we reference these options twice
            // Adds vendor prefixing based on your specified browser support in
            // package.json
            loader: require.resolve('postcss-loader'),
            options: {
              // Necessary for external CSS imports to work
              // https://github.com/facebook/create-react-app/issues/2677
              ident: 'postcss',
              plugins: () => [
                require('postcss-flexbugs-fixes'),
                require('postcss-preset-env')({
                  autoprefixer: {
                    flexbox: 'no-2009',
                  },
                  stage: 3,
                }),
                // Adds PostCSS Normalize as the reset css with default options,
                // so that it honors browserslist config in package.json
                // which in turn let's users customize the target behavior as per their needs.
                postcssNormalize(),
              ],
              sourceMap: false,
            },
          }
        ],
      },

      {
        test: /\.js$/,
        enforce: "pre",
        use: {
          loader: "babel-loader",
          options: {
            cacheDirectory: false,
            presets: ["@babel/preset-env", "@babel/preset-react"],
            plugins: [

              "@babel/plugin-proposal-class-properties",
              [
                "@babel/plugin-proposal-decorators",
                {
                  legacy: true,
                },
              ]
            ],
          },
        },
        exclude: /(node_modules|bower_components)/,
      },
    ],
  },

  //   optimization: {
  //     minimize: true,
  //     minimizer: [
  //         new TerserPlugin({
  //             parallel: 4, // 开启几个进程来处理压缩,默认是 os.cpus().length - 1
  //         }),
  //     ],
  // },
  // 避免把 node_Modules 打包进去
  externals: [nodeExternals()],
  resolve: {
    alias: {
      "^": resolve("src/webapp"),
      "@": resolve("src/webapp/components")

    },
  },
  node: {
    __dirname: false,
    __filename: false

  },
};

module.exports = serverConfig;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
最后更新时间: 10/16/2020, 4:58:54 PM