文件扩展名分析
require()
在分析标识符的过程中,会出现标识符中不包含文件扩展名的情况。CommonJS模块规范也允许在标识符中不包含文件扩展名,这种情况下,Node会按.js
、.json
、.node
的次序补足扩展名,依次尝试。
webpack配置中可以指定匹配的顺序
// 按照指定的扩展名顺序匹配
resolve: {
extensions: ['.js', '.css', '.json', '.jsx']
}
在尝试的过程中,需要调用 fs
模块同步阻塞式地判断文件是否存在。因为Node是单线程的,所以这里是一个会引起性能问题的地方。小诀窍是:如果是.node
和.json
文件,在传递给 require()
的标识符中带上扩展名,会加快一点速度。另一个诀窍是:同步配合缓存,可以大幅度缓解Node单线程中阻塞式调用的缺陷。
目录分析和包
目录分析和包在分析标识符的过程中, require()
通过分析文件扩展名之后,可能没有查找到对应文件,但却得到一个目录,这在引入自定义模块和逐个模块路径进行查找时经常会出现,此时Node会将目录当做一个包来处理。
在这个过程中,Node对CommonJS包规范进行了一定程度的支持。首先,Node在当前目录下查找package.json
(CommonJS包规范定义的包描述文件),通过 JSON.parse()
解析出包描述对象,从中取出 main
属性指定的文件名进行定位。如果文件名缺少扩展名,将会进入扩展名分析的步骤。
webpack中可以指定查找字段的顺序
// 先定位package.json的style字段,没有再定位main字段指定的文件
resolve: {
mainFields: ['style', 'main']
},
而如果 main
属性指定的文件名错误,或者压根没有package.json
文件,Node会将 index
当做默认文件名,然后依次查找index.js
、index.node
、index.json
。
webpack可以指定查找的顺序
// 先找文件名是index文件,没有再找main的文件
resolve: {
mainFiles: ['index', 'main']
},
如果在目录分析的过程中没有定位成功任何文件,则自定义模块进入下一个模块路径进行查找。如果模块路径数组都被遍历完毕,依然没有查找到目标文件,则会抛出查找失败的异常。