说说 Node 文件查找的优先级以及 Require 方法的文件查找策略?
参考答案
require 的查找顺序
require(X) 的路径分析:
- 核心模块:
X是fs/path等内置模块,直接返回,不再找文件。 - 路径型(
X以/、./、../开头):
- 作为文件:精确名 →
X.js→X.json→X.node。 - 作为目录:读
X/package.json的main字段指向的文件 → 依次找X/index.js、X/index.json、X/index.node。
- 非路径型(包名):从当前目录的
node_modules开始逐级向上查找node_modules/X,直到根目录;每个目录内同样按"文件 → package.json main → index"的规则解析。 - 全局路径:
NODE_PATH里的目录(历史遗留,不推荐依赖)。 - 找不到则抛
MODULE_NOT_FOUND。
缓存
- 命中
require.cache[resolvedPath]直接返回module.exports,所以同一模块只执行一次。 - 删除缓存
delete require.cache[path]可强制重新加载(热更新常用,但有副作用)。 - 缓存键是解析后的绝对路径,不同路径指向同一文件(如软链接)可能产生多份实例(
--preserve-symlinks相关)。
ES Module 差异
ESM 走 exports 字段的条件导出(import/require/node/default),且不做扩展名补全与目录 index 查找,必须写完整路径或依赖 exports 映射。
实践
- 优先用
path.join(__dirname, ...)明确路径,避免相对路径随cwd漂移。 - 循环依赖时
require返回未完成的 exports,容易拿到{},需延迟引用或重构。