迷你模块系统
你将构建什么
一个含 define(name, deps, factory) 和 require(name) 的迷你模块系统,能解析依赖、缓存模块并检测循环依赖。
学习目标
- 实现模块注册表(name → module 的 Map)
- 执行工厂前递归解析依赖
- 缓存模块使工厂仅运行一次
- 检测并报告循环依赖
前置要求
- 函数与闭包
- 对象与 Map
- 递归
步骤
- 1
设计 API
决定 API:define(name, deps, factory) 注册模块;require(name) 返回其 exports。记录 deps 如何解析(每个 dep 在工厂运行前被 require)。验收:define + require 对无依赖单模块工作。
提示
参考 AMD(require.js)和 CommonJS——你的迷你系统是简化的 AMD。
- 2
实现注册表和 define
维护模块 Map。define 存储 { deps, factory, exports: undefined, executed: false }。验收:define 后模块在注册表中但尚未执行。
提示
不要在 define 中运行工厂——延迟到 require 以支持懒加载。
- 3
实现带依赖解析的 require
require(name):若模块已执行,返回其 exports。否则递归 require 每个 dep,再调用 factory(...depExports),存储结果、标记已执行并返回。验收:有依赖的模块按序解析依赖。
提示
将 dep exports 作为参数传给工厂,如 AMD:factory.apply(null, depExports)。
- 4
添加循环依赖检测
跟踪当前正在解析的模块集合。若 require 被调用且模块已在集合中,抛出循环依赖错误。验收:A require B require A 抛出清晰错误。
提示
用模块作用域 Set(非实例上)使其每次顶层 require 重置但在递归中保持。
- 5
用依赖图测试
定义三个模块:math(无依赖)、calc(依赖 [math])、app(依赖 [calc, math])。require app 并验证所有工厂按序仅运行一次。再测试循环情况(A→B→A)确认抛出。
提示
在每个工厂内打印日志以确认执行顺序:math 先,calc 次,app 最后。
自己动手试试
你学到了什么
你构建了模块系统的核心——理解它能揭开 import/export、require 和 webpack/rollup 等打包器如何解析依赖和处理循环的神秘面纱。
相关资源
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。