如何分析Node.js应用的文件导入以优化启动时间？

一、使用Node.js内置追踪工具 #

1. --trace-modules + --trace-timing #

直接在启动命令中添加这两个参数，就能输出所有模块的加载路径、顺序及每个模块的加载耗时：

node --trace-modules --trace-timing build/index.js

输出内容包含：

• 每个模块的加载起始/结束时间戳
• 模块解析后的真实路径（含@/*别名映射结果）
• 触发当前模块导入的父模块信息

可以把输出重定向到文件，方便后续筛选分析：

node --trace-modules --trace-timing build/index.js > module-trace.log

通过搜索Loading module或Module loaded关键字，统计各模块耗时，梳理依赖链。

2. 调整--prof参数捕获启动数据 #

之前--prof未捕获到启动数据，是因为默认采样间隔可能跳过了启动阶段的快速操作，试试缩短采样间隔并添加时间事件日志：

node --prof --log-timer-events --prof-interval=1 build/index.js

生成isolate-*-v8.log文件后，过滤启动阶段的采样数据：

node --prof-process --preprocess isolate-*-v8.log | grep -A 20 "Startup"

这样就能看到启动过程中模块加载相关的函数调用和耗时信息。

二、可视化工具分析 #

安装Node.js生态常用的性能分析工具clinic：

npm install -g clinic

使用bubbleprof模式分析启动阶段：

clinic bubbleprof -- node build/index.js

工具会自动记录启动过程中所有模块加载、函数执行的耗时，生成本地可视化页面，你能直观看到：

• 每个模块的加载耗时（气泡大小对应耗时长短）
• 模块间的依赖关系链
• 启动时同步加载的模块（这类模块优先考虑动态导入优化）

三、自定义模块加载追踪器 #

利用Node.js实验性模块加载钩子，写一个精准追踪脚本（trace-loader.js）：

import { resolve as resolvePath } from 'path';

const moduleTimings = new Map();
const dependencyTree = new Map();

export async function load(url, context, defaultLoad) {
  const startTime = Date.now();
  const result = await defaultLoad(url, context, defaultLoad);
  const endTime = Date.now();
  
  const modulePath = resolvePath(url);
  moduleTimings.set(modulePath, endTime - startTime);
  
  // 记录父模块与子模块的依赖关系
  if (context.parentURL) {
    const parentPath = resolvePath(context.parentURL);
    if (!dependencyTree.has(parentPath)) {
      dependencyTree.set(parentPath, []);
    }
    dependencyTree.get(parentPath).push(modulePath);
  }
  
  return result;
}

// 应用启动完成后打印追踪数据
process.on('exit', () => {
  console.log('\n模块加载耗时：');
  Array.from(moduleTimings.entries()).forEach(([path, time]) => {
    console.log(`${path}: ${time}ms`);
  });
  
  console.log('\n依赖导入树：');
  Array.from(dependencyTree.entries()).forEach(([parent, children]) => {
    console.log(`${parent} -> ${children.join(', ')}`);
  });
});

用以下命令启动应用，即可得到完整的模块耗时和导入树：

node --experimental-loader ./trace-loader.js build/index.js

针对你的配置的注意事项 #

• 项目为ES模块（package.json中type: module），所有工具和命令均兼容该模式，无需额外配置。
• tsconfig.json中module: ESNext编译出的是ES模块代码，确保启动命令直接运行编译后的build/index.js文件。

内容的提问来源于stack exchange，提问作者Ludek Vodicka