浅谈node.js模块引入机制

原文链接

之前笔者对nodejs中的模块是如何引入的也是一头雾水,读了一本《深入浅出nodejs》,加上自己工作时的经验和理解,有如下的总结,欢迎同仁指教~

前言

CommonJS的模块规范指出模块主要分为三部分:模块引用、模块定义、模块标识

模块引用

模块引用的示例代码如下:

const math = require('math')

在CommonJS规范中,存在require()方法,这个方法接受的参数为模块标识,以此引入一个模块的API到当前的上下文中。

模块定义

在模块中,上下文提供require()方法来引入外部模块。对应引入共能,上下文还提供了exports对象用于导出当前模块的方法或者变量。模块中还有一module对象,代表模块自身,exportsmodule对象的属性。在Node中,一个文件就是一个模块,将方法挂载在exports对象上作为属性即可定义导出的方式:

// math
exports.add = function add(...args) {
  let sum = 0
  args.forEach(i => {
    sum += i
  })
  return sum
}


在另外一个文件中,通过require()方法引入该模块,就可以调用其方法:

// program.js

const math = require('math')
exports.increment = function(val) {
  return math.add(val, 1)
}

模块标识

模块标识其实就是传递给require()方法的参数,它必须是符合小驼峰命名的字符串,或者以...开头的相对路径,或者绝对路径。它可以没有文件后缀.js

Node的模块加载过程

在Node中引入模块,需要经历3个步骤:

  1. 路径分析
  2. 文件定位
  3. 编译执行

在Node中模块分为两类:一类是Node提供的模块,称为核心模块;另一类是用户编写的,称为文件模块。

优先从缓存中加载

Node会对引用过的模块进行缓存,以减少再次引用时的开销。Node缓存的是编译和执行之后的对象。

不论是核心模块还是文件模块,require()方法对相同模块的二次加载一律采用缓存优先的策略,是 第一优先级的 。不同之处在于核心模块的缓存检查要先于文件模块的缓存检查。

路径分析和文件定位

对于不同的标识符,模块的查找和定位会有不同程度上的差异。

模块标识符分析

模块标识符分为如下几类:

  • 核心模块,如httpfspath等;
  • .或者..开始的相对路径的文件模块;
  • /开始的绝对路径的文件模块;
  • 非路径形式的文件模块,如express模块。

核心模块

核心模块的优先级仅次于缓存加载,加载速度最快,如果想要加载一个和核心模块同名的自定义模块,不会成功

路径形式的文件模块

...开头的标识符,在分析路径是会将其转换为绝对路径并将绝对路径作为索引,将编译执行后的结果存在缓存中。

文件模块给出了文件所在的确切位置,查找可以节约大量时间,加载速度慢于核心模块。

自定义模块

自定义模块指的是非核心模块,也不是路径形式的标识符。它是特殊的一种文件模块,可能是一个文件或者包的形式,这类模块查找最费时间,所以加载最慢。

模块路径 是Node在定位文件模块的具体文件时制定的查找策略,具体表现是一个路径的数组,这个路径的生成规则,可以动手尝试一番:

  1. 创建一个path_test.js的文件,其内容为console.log(module.paths)
  2. 将其放在任意一个目录中并通过node执行node path_test.js

可能会得到如下输出:

[ 'E:\\workspace\\myBlog\\node_modules',
  'E:\\workspace\\node_modules',
  'E:\\node_modules' ]

可以看出,模块路径的生成规则如下:

  • 当前文件目录下的node_modules目录。
  • 父目录下的node_modules目录。
  • 父目录的父目录下的node_modules目录。
  • 沿路径向上逐级递归,直到根目录下的node_modules目录。

可以看出,当前文件的路径越深,模块查找的耗时越多,这是自定义模块加载速度最慢的原因。

文件定位

文件定位还包括一些细节:文件拓展名的分析、目录和包的处理。

文件拓展名的分析

因为模块的标识符也就是require()方法的参数是可以不含有文件拓展名的,这种情况下,Node会按照.js.json.node的次序补足拓展名,依次尝试。

目录分析和包

通过分析文件拓展名之后可能没有得到一个文件,但是得到一个目录此时Node会将目录当作一个包处理。

Node会在当前目录下查找package.json文件,通过JSON.parse()解析出包描述对象,取出main属性来对文件定位。如果main指向的文件没有,或者没有package.json文件,则依次查找index.jsindex.jsonindex.node

目录分析的过程中如果没有成功定位任何文件,则进入下一个模块路径进行定位。所有的模块路径遍历完还没找到则抛出查找失败的异常。

模块编译

注:这里提到的模块编译都是指文件模块

在Node中,每个文件模块都是一个Module对象,可以写一个测试文件console.log(module),并运行得到如下结果:

Module {
  id: '.',
  exports: {},
  parent: null,
  filename: 'E:\\workspace\\myBlog\\test.js',
  loaded: false,
  children:
   [ Module {
       id: 'E:\\workspace\\myBlog\\node_modules\\hehe.js',
       exports: 5,
       parent: [Circular],
       filename: 'E:\\workspace\\myBlog\\node_modules\\hehe.js',
       loaded: true,
       children: [],
       paths: [Array] } ],
  paths:
   [ 'E:\\workspace\\myBlog\\node_modules',
     'E:\\workspace\\node_modules',
     'E:\\node_modules' ] }

具体编译的方式视文件的拓展名而定

JavaScript模块的编译

每个模块文件中存在着requireexportsmodule这三个变量,通过阅读Node的文档,还有__filename__dirname这两个变量,他们从何而来?

实际上,在编译的过程中,Node对获取的Javascript文件的内容进行了包装。将文件包裹在

(function (exports, require, module, __filename, __dirname) {
  // Javascript 文件的内容
})

一个正常的JavaScript文件可能会被包装成这样:

(function (exports, require, module, __filename, __dirname) {
  var math = require('math')
  exports.area= function (radius) {
    return Math.PI * radius * radius
  }
})

这样每个模块文件之间都进行了作用域的隔离,在执行之后,模块的exports属性返回给了调用方,模块的exports属性上的方法以及属性都可以被外部调用的到,其他变量方法不可直接被调用。

另外不可直接对exports赋值,原因在于,exports对象是通过形参的方式传入的,直接赋值形参会改变形参的引用,但不能改变作用域外的值。解决方法是赋值给module.exports对象

C/C++模块的编译

Node调用process.dlopen()方法进行加载和执行,执行的过程中,模块的exports对象与.node模块产生联系,然后返回给调用者。

JSON文件的编译

Node利用fs模块同步读取JSON文件的内容,并将内容通过JSON.parse()得到对象赋给exports对象,供外部调用。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,491评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,856评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,745评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,196评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,073评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,112评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,531评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,215评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,485评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,578评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,356评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,215评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,583评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,898评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,497评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,697评论 2 335

推荐阅读更多精彩内容