---
theme: serene-rose
highlight: atelier-dune-light
---

> 本篇是 Rspack 源码解析系列第九篇。`CodeGenerationPass` 生成的并不只有 JavaScript source，还包含 `runtime_requirements`。本篇追踪 `RuntimeRequirementsPass`：模块如何声明能力需求，需求怎样汇总到 Chunk 和入口树，以及 runtime module 如何被安装。

## 前言：模块只声明“需要什么”

一个模块中的 `import()` 可能需要“加载 Chunk”的能力；ESM 导出可能需要“定义 getter”的能力。模块不应自行把这些 helper 全部拼进 source，否则每个模块都会重复实现，也无法按不同 target/runtime 替换实现。

因此第五篇中的 `CodeGenerationResult` 会输出一个集合：

```text
module source
  + RuntimeGlobals(require, ensure_chunk, define_property_getters, ...)
```

`RuntimeRequirementsPass` 的工作是将“能力声明”变为实际可用的 runtime 实现。

## 入口：两级计算

Pass 首先分模块、再分 Chunk 处理：

```rust
compilation.process_modules_runtime_requirements(modules, plugin_driver.clone()).await?;
compilation.process_chunks_runtime_requirements(chunks, runtime_chunks, plugin_driver.clone()).await?;
```

数据流可以画成：

```text
CodeGenerationResult(module, runtime)
       |
       v
模块 runtime requirements
       |
       v
Chunk runtime requirements（合并其模块需求）
       |
       v
Entrypoint tree runtime requirements（合并可加载路径）
       |
       v
RuntimeModule + runtime chunk source
```

## 模块级：按 module + runtime 保存

同一模块可能在多个 runtime 中生成不同结果，所以模块需求也不能只存一份。`process_modules_runtime_requirements()` 从 `CodeGenerationResults` 读取指定 runtime 的 requirements，并调用两个扩展点：

```text
additional_module_runtime_requirements
runtime_requirement_in_module
```

后者可返回新的 requirement。代码使用集合差集，只把本轮新增项继续传播，直到不再产生新能力：

```text
requirements = { ensure_chunk }
插件补充 = { get_chunk_script_filename }
新增集合非空 -> 再跑一轮
没有新增 -> 收敛
```

这是依赖闭包的计算。`ensure_chunk` 的实现本身需要知道资源文件名，因此会派生出新的 runtime global。

## Chunk 级：把模块能力合并为加载单元能力

Chunk 级逻辑会遍历其所有模块：

```rust
for module in chunk_graph.get_chunk_modules(chunk) {
  if let Some(requirements) = ChunkGraph::get_module_runtime_requirements(
    compilation, module, chunk.runtime()
  ) {
    set.insert(*requirements);
  }
}
```

它还会调用 `additional_chunk_runtime_requirements`，并让 Hook 在 `runtime_requirement_in_chunk` 中添加 RuntimeModule。最终集合写回 `ChunkGraph::set_chunk_runtime_requirements`。

例如异步 Chunk 的入口模块出现 `import()` 时，Chunk 会得到 `ensure_chunk`、`get_chunk_script_filename` 等需求，插件据此把 JSONP、importScripts 或其他 target 对应的加载实现加入 runtime。

## Tree 级：为什么还要再汇总一次

某些 runtime 能力必须在入口 runtime 中可用，而不仅仅是某个子 Chunk。`process_tree_runtime_requirements()` 从每个 entrypoint 向其可达的 Chunk 树汇总：

```text
main runtime
  -> main Chunk requirements
  -> lazy Chunk requirements
  -> 得到整棵树所需能力
```

同样使用“新增项继续传播直到收敛”的固定点循环。这样，某个 RuntimeModule 反过来要求的能力也不会漏掉。

## RuntimeModule 何时生成代码

运行时模块不是普通源文件，但它也实现 `RuntimeModule`，并在后续 `CreateHashPass` 中调用 `runtime_modules_code_generation()`。这个拆分很关键：

```text
RuntimeRequirementsPass：决定需要哪些 RuntimeModule
CreateHashPass：为它们生成代码并纳入 hash
CreateChunkAssetsPass：将它们和业务模块一起渲染
```

所以 runtime requirement 阶段本身不直接拼出 `main.js`。

## 增量构建：只重新计算受影响集合

源码会从 `Mutation::ModuleSetHashes` 和受影响 Chunk 中筛选对象。若缓存不可复用，则清空对应 artifact 并全量处理；否则只移除被删模块或受影响 Chunk 的旧记录。这里体现了 Rspack 增量构建的通用方式：

```text
Mutation 记录变化
  -> pass 计算影响范围
  -> 复用未受影响 artifact
  -> 重算局部结果
```

## 这一篇应该带走什么

1. `runtime_requirements` 是模块声明能力，不是 helper 的最终实现；
2. 需求按 Module、Chunk、Entrypoint Tree 三层汇总；
3. Hook 可把一种能力扩展为更多依赖，并通过固定点循环收敛；
4. RuntimeModule 在 requirement 阶段被选择，在后续 hash 阶段生成源码；
5. Rspack 用 Mutation + Artifact 缩小增量计算范围。

## 写在最后

现在模块代码、runtime module 列表和 Chunk runtime requirements 都已确定。接下来需要计算内容 hash，并把这套中间结果转换为真实 asset。下一篇会追 `CreateHashPass`、`CreateModuleAssetsPass` 与 `CreateChunkAssetsPass`。

本篇是 Rspack 源码解析系列第九篇。CodeGenerationPass 生成的并不只有 JavaScript source，还包含 runtime_requirements。本篇追踪 RuntimeRequirementsPass：模块如何声明能力需求，需求怎样汇总到 Chunk 和入口树，以及 runtime module 如何被安装。

Rspack 源码解析（九）：Runtime Requirements 与 RuntimeModule

前端

开发工具

架构设计

本篇解析Rspack的RuntimeRequirementsPass：模块声明能力需求（如ensure_chunk），按Module、Chunk、EntrypointTree三层汇总，经固定点循环收敛。RuntimeModule在需求阶段选择，后续hash阶段生成代码。增量构建通过Mutation与Artifact复用，只重算受影响部分，提升效率。

代码解释

数据流

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本篇解析Rspack的RuntimeRequirementsPass：模块声明能力需求（如ensure_chunk），按Module、Chunk、EntrypointTree三层汇总，经固定点循环收敛。RuntimeModule在需求阶段选择，后续hash阶段生成代码。增量构建通过Mutation与Artifact复用...

Rspack 源码解析（九）：Runtime Requirements 与 RuntimeModule-腾讯云开发者社区-腾讯云

Rspack 源码解析（九）：Runtime Requirements 与 RuntimeModule

Rspack 源码解析（九）：Runtime Requirements 与 RuntimeModule

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐