「项目实战」优化项目构建时间-建设项目例子

[[399761]]

背景

前几天晚上下班的时候，路过隔壁项目组，听他们在聊项目构建的事：

现在线上打包时间太长了，修个 bug 1 分钟，发布一下半小时, 贼难受。

他们项目比较庞大，线上构建时间特别长，基本都在15分钟以上。

和他们简单聊了会，回去瞅了一下自己项目的构建时间：

其实也挺长的，于是抽空优化了一下，效果还是比较明显的。

优化后：

在正文部分，我将分享的内容主要是：

一些提升 webpack 打包性能的配置
优化大型项目构建时间的一些思考

希望对大家有所启发。

[[399762]]

正文

我们项目不是很大, 是一个中型的国际化项目, 一百来个页面。

之前本地构建时间挺长的，初次启动要三次分钟，后面我配置了 Vite, 本地启动时间降低到了 20s 左右，感兴趣的可以移步我这篇文章：

[项目实战] Webpack to Vite，为开发提速!

看了一下，线上构建时间五六分钟，不痛不痒，但是应该也有优化空间，于是准备优化一下。

1. 发现问题

既然要优化构建时间，第一步当然是先发现问题，找出比较耗时的阶段，再加以优化。

这里我用到了SMP 插件。

SMP 插件用法非常简单，这里也简单提一下：

// webpack.config.js 
const SpeedMeasurePlugin = require('speed-measure-webpack-plugin'); 
const smp = new SpeedMeasurePlugin(); 
 
module.exports = smp.wrap({ 
  // ... 
});

利用 SMP 插件得出各个阶段的打包耗时：

发现问题

发现两个比较明显的问题：

IgnorePlugin 耗时接近 20 秒。
less-loader 部分执行了2次，浪费了一分多钟。
ts-loader 耗时一分半，也挺长的。

2. 解决问题

1. IgnorePlugin

查看了一下配置，发现配置里的 IgnorePlugin 并没有达到预期的效果，删掉。

2. less-loader

查看配置后发现，在处理less的部分，确实多处理了一遍。

less 文件的处理，可以直接看官方文档，文档地址：

https://webpack.docschina.org/loaders/less-loader/

我的配置：

{ 
  test: /\.less$/, 
  use: [ 
    'style-loader', 
    'css-loader', 
    { 
      loader: 'less-loader', 
      options: { 
        javascriptEnabled: true, 
        sourceMap: true, 
        modifyVars: { 
          // inject our own global vars 
          // https://github.com/ant-design/ant-design/issues/16464#issuecomment-491656849 
          hack: `true;@import '${require.resolve('./src/vars.less')}';`, 
          ...themeVariables, 
        }, 
        limit: 10000, 
        name: '[name].[hash:7].[ext]', 
        outputPath: 'styles/', 
      }, 
    }, 
  ], 
}, 
{ 
  test: /\.css$/, 
  use: ['style-loader', 'css-loader'], 
},

3. ts-loader

对于ts-loader部分的优化，可以参考：

https://webpack.js.org/guides/build-performance/#typescript-loader

文档上也有比较清晰的描述：

文档建议，我们开启transpileOnly选项，关闭类型检查。

如果要类型检查，可以使用 ForkTsCheckerWebpackPlugin，这个插件会在另外一个进程中做相关的检查。

这个插件，我们在优化构建时内存溢出的问题上，也做了探索，感兴趣的可以移步我这篇文章：

项目构建内存溢出了?看看 Node 内存限制

现在我们也开启这个选项。

开启之后，本地构建的时候，本地报了个警告：

这个错误，十分的眼熟，是之前我们讲过的 import type 的问题：

你不知道的「 import type 」

修复一下：

问题解决。

重新构建，得到如下结果：

优化之后之后，我们发现：

IgnorePlugin、HtmlWebpackPlugin 时间大幅缩短。
less-loader 等恢复了正常，只执行了一次。
ts-loader 时间大幅缩短，由1分30秒缩短为40秒。

本地效果明显，需要去线上构建验证。

3. 确认有效

在线上执行之后，得到如下结果：

然后去检查了一下页面，也都是正常的。

完美!

回头看，不难发现，其实也没改多少东西，就收获了不错的效果。

针对中小型项目来说，改改配置往往就能达到我们的要求，但是如果是面对大型项目呢?

比如那种数十个模块，几百个页面的项目。

回到开头那个问题：修个 bug 1 分钟，发布一下半小时。

简单的修改配置，都无法把时间降下来，这时候该怎么办呢?

优化大型项目构建时间的一些思考

拆分子应用

假设我们有一个项目，大模块就有将近30个：

每个大模块里面又有几十个页面，这种系统构建时间会比较久，需要做优化。

而且到了项目后期，问题会越来越明显, 比如：

代码越来越臃肿
业务模块本身无关联
构建速度越来越慢
无法独立部署

面对这种情况，一种可行的做法是：拆分子应用。

拆分之后的架构：

每个子项目都有单独的入口，是可以独立部署的项目。

子项目打成单独umd包:

在主项目启动的时候，再去加载这些子项目：

加载完成之后，需要处理路由以及store, 示例代码：

// base 
export const bootstrap = () => { 
  // ... 
  ReactDOM.render(( 
    <Provider store={store}> 
      <Router history={history}> 
        <App defaultInitialData={_initialData} /> 
      </Router> 
    </Provider> 
  ), document.getElementById('root')); 
  return Promise.resolve(); 
}; 
 
// main 
const loadSubApp = (htmlEntry: string) => { 
  return importHTML(`${htmlEntry}?${Date.now()}`) 
    .then((res: any) => res.execScripts()) 
    .then((exportedValues: any) => { 
      console.log(`importHTML: ${htmlEntry} loaded, exports:`, exportedValues); 
      const { store, router } = exportedValues || {} as any; 
      router && addCustomRouter(router); 
      store && addCustomStore(store); 
    }) 
    .catch(e => { 
      console.error('importHTML: ${htmlEntry} load error:', e); 
    }); 
}; 
 
const load = () => { 
  if (__ENV__ !== 'dev') { 
    const paths: string[] = []; 
    subAppConfig.subApps.forEach(item => { 
      if (item.project === localStorage.getItem('ops_project')) { 
        paths.push(...item.paths); 
      } 
    }); 
    Promise.all(paths.map(path => loadSubApp(path))) 
      .catch(e => console.log(e)) 
      .finally(setAllLoaded); 
  } else { 
    setAllLoaded(); 
  } 
}; 
 
const init = () => { 
  console.log('init: Start to bootstrap the main APP'); 
  addCustomStore(rootStore); 
  bootstrap().then(() => { 
    load(); 
  }); 
}; 
 
init();

代码共享

common包
component
utils
typings
..
externals
react全家桶
moment
antd
..

样式隔离

给样式添加以子项目为名的 namespace :

开发调试

以 ops 项目为例。

让开发调试 ops-common 包像本地文件一样方便:

1.让项目来编译 common 包

2.wepback alias

3.TS alias

独立部署

在同一个project上为每个子项目申请独立module

拆分子应用的优缺点

优点：

每个子应用都可以独立发布，子模块和主模块解耦。

子项目是可以单独编译的，主项目只需要做引入即可，以此减少主模块的构建时间。

缺点：

额外的复杂性和维护成本

结论

一般来说，对于中小型项目，做好打包配置的优化，能够解决一部分问题。

大型项目的构建时间优化，可以考虑拆分子应用的模式。

只不过这种模式需要考虑一些维护的问题，比如如何维护版本 tag、如何快速回滚等。

这些需要结合你们项目的实际情况再做决定。

今天的内容就这么多，希望对大家有所启发。