"循环加载"(circular dependency)指的是,a
脚本的执行依赖b
脚本,而b
脚本的执行又依赖a
脚本。
// a.js var b = require('b'); // b.js var a = require('a');
通常,"循环加载"表示存在强耦合,如果处理不好,还可能导致递归加载,使得程序无法执行,因此应该避免出现。
但是实际上,这是很难避免的,尤其是依赖关系复杂的大项目,很容易出现a
依赖b,b
依赖c
,c
又依赖a
这样的情况。这意味着,模块加载机制必须考虑"循环加载"的情况。
本文介绍JavaScript语言如何处理"循环加载"。目前,最常见的两种模块格式CommonJS和ES6,处理方法是不一样的,返回的结果也不一样。
一、CommonJS模块的加载原理
介绍ES6如何处理"循环加载"之前,先介绍目前最流行的CommonJS模块格式的加载原理。
CommonJS的一个模块,就是一个脚本文件。require
命令第一次加载该脚本,就会执行整个脚本,然后在内存生成一个对象。
{ id: '...', exports: { ... }, loaded: true, ... }
上面代码中,该对象的id
属性是模块名,exports
属性是模块输出的各个接口,loaded
属性是一个布尔值,表示该模块的脚本是否执行完毕。其他还有很多属性,这里都省略了。(详细介绍情参见《require() 源码解读》。)
以后需要用到这个模块的时候,就会到exports
属性上面取值。即使再次执行require
命令,也不会再次执行该模块,而是到缓存之中取值。
二、CommonJS模块的循环加载
CommonJS模块的重要特性是加载时执行,即脚本代码在require
的时候,就会全部执行。CommonJS的做法是,一旦出现某个模块被"循环加载",就只输出已经执行的部分,还未执行的部分不会输出。
让我们来看,官方文档里面的例子。脚本文件a.js
代码如下。
exports.done = false; var b = require('./b.js'); console.log('在 a.js 之中,b.done = %j', b.done); exports.done = true; console.log('a.js 执行完毕');
上面代码之中,a.js
脚本先输出一个done
变量,然后加载另一个脚本文件b.js
。注意,此时a.js
代码就停在这里,等待b.js
执行完毕,再往下执行。
再看b.js
的代码。
exports.done = false; var a = require('./a.js'); console.log('在 b.js 之中,a.done = %j', a.done); exports.done = true; console.log('b.js 执行完毕');
上面代码之中,b.js
执行到第二行,就会去加载a.js
,这时,就发生了"循环加载"。系统会去a.js
模块对应对象的exports
属性取值,可是因为a.js
还没有执行完,从exports
属性只能取回已经执行的部分,而不是最后的值。
a.js
已经执行的部分,只有一行。
exports.done = false;
因此,对于b.js
来说,它从a.js
只输入一个变量done
,值为false
。
然后,b.js
接着往下执行,等到全部执行完毕,再把执行权交还给a.js
。于是,a.js
接着往下执行,直到执行完毕。我们写一个脚本main.js
,验证这个过程。
var a = require('./a.js'); var b = require('./b.js'); console.log('在 main.js 之中, a.done=%j, b.done=%j', a.done, b.done);
执行main.js
,运行结果如下。
$ node main.js 在 b.js 之中,a.done = false b.js 执行完毕 在 a.js 之中,b.done = true a.js 执行完毕 在 main.js 之中, a.done=true, b.done=true
上面的代码证明了两件事。一是,在b.js
之中,a.js
没有执行完毕,只执行了第一行。二是,main.js
执行到第二行时,不会再次执行b.js
,而是输出缓存的b.js
的执行结果,即它的第四行。
exports.done = true;
三、ES6模块的循环加载
ES6模块的运行机制与CommonJS不一样,它遇到模块加载命令import
时,不会去执行模块,而是只生成一个引用。等到真的需要用到时,再到模块里面去取值。
因此,ES6模块是动态引用,不存在缓存值的问题,而且模块里面的变量,绑定其所在的模块。请看下面的例子。
// m1.js export var foo = 'bar'; setTimeout(() => foo = 'baz', 500); // m2.js import {foo} from './m1.js'; console.log(foo); setTimeout(() => console.log(foo), 500);
上面代码中,m1.js
的变量foo
,在刚加载时等于bar
,过了500毫秒,又变为等于baz
。
让我们看看,m2.js
能否正确读取这个变化。
$ babel-node m2.js bar baz
上面代码表明,ES6模块不会缓存运行结果,而是动态地去被加载的模块取值,以及变量总是绑定其所在的模块。
这导致ES6处理"循环加载"与CommonJS有本质的不同。ES6根本不会关心是否发生了"循环加载",只是生成一个指向被加载模块的引用,需要开发者自己保证,真正取值的时候能够取到值。
请看下面的例子(摘自 Dr. Axel Rauschmayer 的《Exploring ES6》)。
// a.js import {bar} from './b.js'; export function foo() { bar(); console.log('执行完毕'); } foo(); // b.js import {foo} from './a.js'; export function bar() { if (Math.random() > 0.5) { foo(); } }
按照CommonJS规范,上面的代码是没法执行的。a
先加载b
,然后b
又加载a
,这时a
还没有任何执行结果,所以输出结果为null
,即对于b.js
来说,变量foo
的值等于null
,后面的foo()
就会报错。
但是,ES6可以执行上面的代码。
$ babel-node a.js 执行完毕
a.js
之所以能够执行,原因就在于ES6加载的变量,都是动态引用其所在的模块。只要引用是存在的,代码就能执行。
我们再来看ES6模块加载器SystemJS给出的一个例子。
// even.js import { odd } from './odd' export var counter = 0; export function even(n) { counter++; return n == 0 || odd(n - 1); } // odd.js import { even } from './even'; export function odd(n) { return n != 0 && even(n - 1); }
上面代码中,even.js
里面的函数foo
有一个参数n
,只要不等于0,就会减去1,传入加载的odd()
。odd.js
也会做类似操作。
运行上面这段代码,结果如下。
$ babel-node > import * as m from './even.js'; > m.even(10); true > m.counter 6 > m.even(20) true > m.counter 17
上面代码中,参数n
从10变为0的过程中,foo()
一共会执行6次,所以变量counter
等于6。第二次调用even()
时,参数n
从20变为0,foo()
一共会执行11次,加上前面的6次,所以变量counter
等于17。
这个例子要是改写成CommonJS,就根本无法执行,会报错。
// even.js var odd = require('./odd'); var counter = 0; exports.counter = counter; exports.even = function(n) { counter++; return n == 0 || odd(n - 1); } // odd.js var even = require('./even').even; module.exports = function(n) { return n != 0 && even(n - 1); }
上面代码中,even.js
加载odd.js
,而odd.js
又去加载even.js
,形成"循环加载"。这时,执行引擎就会输出even.js
已经执行的部分(不存在任何结果),所以在odd.js
之中,变量even
等于null
,等到后面调用even(n-1)
就会报错。
$ node > var m = require('./even'); > m.even(10) TypeError: even is not a function
[说明] 本文是我写的《ECMAScript 6入门》第20章《Module》中的一节。
(完)
surgit 说:
nice.
2015年11月 2日 19:24 | # | 引用
xxd 说:
贴个参考
https://hacks.mozilla.org/2015/08/es6-in-depth-modules/
2015年11月 2日 22:22 | # | 引用
fakefish 说:
好奇这个es6的动态加载是怎么做到的
2015年11月 2日 22:56 | # | 引用
dou4cc 说:
那以后JS是不是要搞惰性求值?
2015年11月 4日 21:32 | # | 引用
eric 说:
最后一个例子,变量even等于null,那应该是even is not a function报错,为啥报错的是TypeError: odd is not a function
2015年11月 6日 08:10 | # | 引用
阮一峰 说:
@eric
谢谢指出,原代码有错误,已经改正了
2015年11月 6日 17:45 | # | 引用
ss 说:
1024ss.com 解决程序员难言之隐!
2015年11月 9日 08:50 | # | 引用
sasumi 说:
模块在调用时才加载模块,这个对开发人员来说并不是一个好的主意。
这样定义意味着模块文件只能是类库,而不能是自执行代码。 相当于丧失了这部分语言能力。
就如java。
2015年11月11日 22:47 | # | 引用
xgqfrms 说:
2015年11月12日 19:53 | # | 引用
丰千郎 说:
写的很有深度
2015年11月13日 15:41 | # | 引用
严寒 说:
压根就不应该给循环依赖容错。循环依赖是一种不好的设计,他本身就是在增加维护难度。所以加载的时候发现有循环依赖的情况,直接报错就好了。seajs是不是就是这么做的?
2015年11月15日 11:23 | # | 引用
karol 说:
阮老师,你是工作之后再考研的吗?我今年毕业,工作半年了,想请教下如果辞职考研的话是否毕业时年纪大了点。本科也是学的经济现在做程序员感觉自己基础太差想好好补下
2015年11月19日 18:58 | # | 引用
Husayn 说:
我就想问问,当在一个页面内 使用 ajax 进行局部刷新了页面,但在这个局部里面我又想利用ajax来处理某些东西时,这时发现js 不起作用了,,,,,, 这是为什么呢??
2015年11月27日 17:01 | # | 引用
armvs.com 说:
大牛,看不明白。不过经常看慢慢有感觉。
2015年11月30日 20:47 | # | 引用
Callwoola 说:
npm导致依赖包异常臃肿
2015年12月 7日 18:09 | # | 引用
焦贵彬 说:
那么也就是说模块循环加载的情况中必须得要有跳出的条件吗?否则会无限循环加载?
2017年3月12日 21:02 | # | 引用
苏鹤 说:
关于您提到的:ES6模块的运行机制与CommonJS不一样,它遇到模块加载命令import时,不会去执行模块,而是只生成一个引用。等到真的需要用到时,再到模块里面去取值。
我不这样认为, 如果A文件中有一个console.log("A"); 当B文件importA的时候,控制台就会输出A,所以我认为程序运行时遇到import会立即执行被引用的文件。不知道我理解的是否有误,班门弄斧,向您请教。
2017年10月31日 09:56 | # | 引用
rogue 说:
脚本里的代码肯定是会被执行的, 关键在于在**哪个阶段**执行. ES6不同于CommonJS, 是在分析完整个依赖关系之后, 再逆序执行一连串文件中的代码(也就是你说的console.log("A")会被执行)。
你的疑惑应该在于阮老师说的「不会去执行模块」,我觉得是措辞方面的细节,领会意思就好,
2017年11月 9日 01:42 | # | 引用
rogue 说:
继续补充: 文中要表达的「执行」, 是指import的变量只是一个声明, 并没有给该变量明确的赋值, 也就是所谓的没有「执行」。 比如import {time} from '/A.js'; 在A.js中, export time = Date.now();
time自身在被import的时候是没有确定的值, 也就是Date.now()在import {time} from '/A.js'时不会执行, 而只有在time变量被使用的时候, 才会「执行」Date.now() . 上面说的这一堆才是文中表达的「是否执行」的问题。 跟你举的例子「如果A文件中有一个console.log("A"); 当B文件importA的时候,控制台就会输出A」不是说的一个事情哟
2017年11月 9日 01:55 | # | 引用
rogue 说:
Date.now()的示例是错了, 我想表达的是 --- time的值可能会被改变, 而外部使用time时获取的会是新的值, 而不是在import {time} 时就被定死了.
2017年11月 9日 02:05 | # | 引用
animabear 说:
可以结合这篇来看:https://mp.weixin.qq.com/s/-FtZUxgcEdfi05yps86G0w
2018年5月15日 14:38 | # | 引用
牧云云 说:
现在有什么模块能在 node 环境里跑 ES6 的模块吗?在 npm 的仓库里找不着 babel-node 这个模块了
2018年9月 7日 11:48 | # | 引用
Rocker_Lau 说:
上面代码中,even.js里面的函数foo有一个参数n,只要不等于0,就会减去1。。。。
应该是
上面代码中,even.js里面的函数even有一个参数n,只要不等于0,就会减去1。。。。
2018年11月23日 12:13 | # | 引用
findcoins 说:
let a = require('./aprototype');
function bprototype() {}
console.log('b require a get:', a);
bprototype.prototype.do = function() {
console.log('bprototype.js->do......');
}
bprototype.prototype.calla = function() {
console.log('call a....');
a.do();
}
module.exports = new bprototype();
求教, 这个prototype的函数的情况下为什么 循环引用发生的问题更严重:即整个程序在初始化完成之后, let a = require('./aprototype'); 里的a也无法得到完整的脚本。
2019年2月28日 15:29 | # | 引用
findcoins 说:
我把我完整的测试程序帖上来:
let b = require('./bprototype');
function aprototype() {}
console.log('a require b get:', b);
aprototype.prototype.do = function() {
console.log('aprototype.js->do......');
}
aprototype.prototype.callb = function() {
console.log('call b....');
b.do();
}
module.exports = new aprototype();
2019年2月28日 15:31 | # | 引用
关关 说:
怎么才知道代码用的comonjs还是es6呢
2019年4月24日 10:58 | # | 引用
小寒 说:
阮老师,我理解的是其实是因为babel转化阶段的问题
import { a } from 'a'
console.log(a)
会被babel转化为
const aModule = require('a')
console.log(aModule.a)
所以会导致出现的上边的现象,假如用export default导出就会和commonJs表现一致了。
2019年11月19日 19:51 | # | 引用
许广诚 说:
差不多我感觉
2021年2月25日 11:54 | # | 引用
xiao_ming 说:
这里的even应该是undefined吧
2021年4月 4日 18:02 | # | 引用
那达 说:
要了解ES Module如何通过webpack/rollup实现,请看这个回答https://stackoverflow.com/a/67173273/6058886
如果要了解原生ES Module如何实现(包括如何规避循环依赖),可以看上面回答最后的链接: 简单来讲,不像commonjs的模块,是通过运行时建立关系(即通过函数调用),ES Module原生实现是通过分析依赖关系建立依赖关系绑定 + 执行模块代码填充exports值等多步来完成的。
此外, 阮大神文章中说”上面代码表明,ES6模块不会缓存运行结果,而是动态地去被加载的模块取值,以及变量总是绑定其所在的模块。“说法不准确, ES6模块导出的结果,如果是非原生ES Module实现, 返回的其实是一个属性getter,这个getter是由被引用模块返回的,因此总能拿到最新值。
2021年4月21日 15:30 | # | 引用
lazy_ 说:
本质问题是cjs的module exports可以通过module.exports = xxx修改。而esm 不可能,看过webpack编译结果的都知道,export default的时候,结果是 { defalult: xxx, __esModule: true}。其实cjs的导出不使用module.exports = xxx,只是用module.exports = {xxx},是不会有任何循环依赖问题的。
2021年8月23日 14:40 | # | 引用
Fargo 说:
上面代码中,even.js里面的函数foo有一个参数n,只要不等于0,就会减去1,传入加载的odd()。odd.js也会做类似操作。
勘误:even.js 里面的函数 `even`
2022年5月12日 16:35 | # | 引用