Node.js模块子路径解析规则及自定义配置技术问询

咱们一步步拆解你的问题，把这些逻辑讲明白：

一、默认情况下的路径解析规则 #

不管你用CommonJS的require还是ES模块的import，Node.js的模块解析器默认都会在my-module的根目录下按以下顺序查找目标文件：

• 首先寻找subpath.js（ES模块优先匹配subpath.mjs，CommonJS匹配subpath.cjs）
• 如果没找到上述文件，就会尝试找subpath文件夹下的入口文件：比如subpath/index.js（同样会根据模块类型匹配对应后缀）
• 如果这些都找不到，解析就会失败，抛出模块找不到的错误

所以默认情况下，路径确实指向my-module根目录下的subpath.js或subpath/index.js，不会自动指向其他位置。

二、如何配置让导入路径指向lib/subpath/index.js？ #

这时候就要用到Node.js支持的package.json中的exports字段——它是自定义模块导出路径的核心配置，优先级高于默认的解析规则。

具体配置步骤很简单：

1. 在my-module的根目录下打开package.json
2. 添加exports字段，明确指定./subpath对应的文件路径：

{
  "name": "my-module",
  "exports": {
    "./subpath": "./lib/subpath/index.js"
  }
}

配置完成后，不管你用require('my-module/subpath')还是import * from 'my-module/subpath'，Node.js都会直接解析到lib/subpath/index.js，完全跳过默认的根目录查找逻辑。

进阶：通配符批量配置子路径 #

如果你的模块有很多类似的子路径（比如my-module/subpath/foo、my-module/subpath/bar），还可以用通配符来批量配置：

{
  "name": "my-module",
  "exports": {
    "./subpath/*": "./lib/subpath/*.js"
  }
}

这样import * from 'my-module/subpath/foo'就会自动指向lib/subpath/foo.js，非常省心。

补充说明 #

• exports字段在Node.js 12.7.0+（ES模块）和Node.js 14.13.0+（CommonJS）开始支持，现在大部分项目都已经兼容这个特性；如果需要适配更低版本，可能需要额外处理，但一般不推荐。
• 要是你需要同时支持CommonJS和ES模块的不同入口，还可以在exports里配置条件导出，针对require和import分别指定文件，但如果只是统一指向lib目录下的文件，上面的基础配置就足够了。

内容的提问来源于stack exchange，提问作者Alasdair McLeay