#FAQ

#如何只使用 Rsdoctor 的某个功能？

当我们只需要 Rsdoctor 内 Bundle Size 分析产物大小的功能时，我们可以在接入 Rsdoctor 插件时配置对应的 Features 配置项，参考下方代码：

import { RsdoctorRspackPlugin } from '@rsdoctor/rspack-plugin';

new RsdoctorRspackPlugin({
  features: ['bundle'], // 代表只开启 bundle size 的功能分析
});

#Loader 耗时数据不准？

Rsdoctor 提供的 Loader 耗时时间是预估耗时，为什么没法统计到准确耗时？是因为我们知道 Loader 执行可能是异步函数也可能是同步函数，同时，打包工具会并行执行多个不冲突的 Loader 函数，其中 JS 是单线程的，多个 Loader 函数均可能抢占当前的任务队列，同时 Loader 函数内的异步逻辑没法识别，导致单个 Loader 函数在执行过程中，可能横跨多个其他 Loader 的执行过程，所以会存在如下图所示的三种 case：

因此，Rsdoctor 提供的 Loader 耗时是一个预估的数据，而我们给出的耗时数据适配了上图中 Case 1 和 Case 2 的情况，对于 Case 3 的解决方案，我们目前还在探索中。

#使用Rsdoctor 构建时出现了out of memory 问题

如果出现了 out of memory 的报错，可以尝试下列两个方法，推荐优先使用第一个：

#方法一

增大 node 内存上限, 例如：NODE_OPTIONS=--max-old-space-size=8096。

#方法二

可以在 features 数组中添加 lite 字段，使用 lite 模式，同时，因为 features 为数组时会覆盖掉默认配置，所以：

• 如果需要构建时分析，features 数组中添加 loader 和 plugins，是开启 loader 和 plugins 的耗时分析。

• 如果需要构建产物分析，features 数组中添加 bundle，是开启构建产物分析。

下面示例是开启了 lite 模式以及构建时和构建产物分析：

const { RsdoctorRspackPlugin } = require('@rsdoctor/rspack-plugin');

// adding the plugin to your configuration
module.exports = {
  // ...
  plugins: [
    new RsdoctorRspackPlugin({
      disableClientServer: false,
      features: ['lite', 'loader', 'plugins', 'bundle'],
    }),
  ].filter(Boolean),
};

• 原因：因为构建过程中，存储了源码信息，超过了内存，所以开启 lite 模式可以缓解。
• 区别：lite 模式和普通模式的区别就是不再存储源码信息，只存储打包后的代码，同时分析报告上的代码也将只有打包后的代码。

#产物分析界面没有Bundled Size 怎么办？

#问题说明

Source Size 和 Bundled Size 的区别：

• Source Size：Module 文件源码的原始大小（如下图紫色标识）。
• Bundled Size：经过打包及压缩后的 Module 的最终代码大小（如下图青色标识）。

#原因分析

当 optimization.concatenateModules 配置为 true 时，Rsdoctor 无法通过 acorn 解析产物来分解出每个 Module 的实际代码大小，因此无法显示 Bundled Size。

#解决方案

在开启 Rsdoctor 分析时，配置 concatenateModules 为 false，如下所示。同时要注意，关闭 concatenateModules 一定会导致产物体积略微变大，与线上环境的体积有一些差异。

export default {
  optimization: {
    concatenateModules:
      process.env.NODE_ENV === 'production' && !process.env.RSDOCTOR, // 需要判断 RSDOCTOR 环境变量，不可以直接修改 concatenateModules！
  },
};

• rspeedy 项目中，在 rspeedy.config.ts 中配置：

  export default {
    tools: {
      rspack(config, { env }) {
        if (process.env.RSDOCTOR === 'true') {
            config.optimization = {
              ...config.optimization,
              concatenateModules: false,
            },
            return config
          }
      },
    },
  };

#CssExtractRspackPlugin 的 loader 耗时过长问题

在使用 Rsdoctor 对 Rspack 项目进行编译耗时分析时，可能会发现 CssExtractRspackPlugin 的 loader 耗时较长。然而，这个数值并不代表 CssExtractRspackPlugin 的 loader 的真实耗时，它还包含了对本模块编译的其他 loader 的耗时。

• 原因：CssExtractRspackPlugin 中的 loader 在 pitch 阶段会异步调用其他 loader，并等待这些 loader 执行后的回调结果。因此，CssExtractRspackPlugin 的耗时实际上包括了其他 loader 的执行时间和空闲时间。