如何在ESM架构的NPM Monorepo中获取模块的实际安装路径？

问题场景 #

我有一个采用ESM架构的NPM Monorepo项目，目录结构如下：

<root>
|_package.json
|_node_modules/
| |_luxon (1.28.0)
|_packages/
  |_pack1
  | |_node_modules/
  | | |_luxon (3.0.1)
  | |_main.js
  |_pack2
    |_node_modules/
    |_main.js

需要实现一个方法，在任意main.js中调用时，能返回对应模块的实际安装路径：

• 执行pack1/main.js时，调用方法获取luxon路径，结果为<root>/packages/pack1/node_modules/luxon
• 执行pack2/main.js时，调用方法获取luxon路径，结果为<root>/node_modules/luxon

解决方案 #

利用ESM原生的import.meta.resolve()方法，它会遵循Node.js的模块解析规则（优先当前包的node_modules，逐层向上查找），返回模块入口的URL。再将URL转换为本地文件系统路径，即可得到目标模块的安装目录。

代码实现 #

以下是可直接使用的工具函数，包含路径处理逻辑：

import path from 'path';

/**
 * 获取模块的根安装目录
 * @param {string} moduleName - 要查找的模块名称
 * @returns {Promise<string>} 模块的绝对安装路径
 */
async function getModuleRootDir(moduleName) {
  // 直接解析模块的package.json文件，确保拿到的是模块根目录
  const packageJsonUrl = await import.meta.resolve(`${moduleName}/package.json`);
  // 将URL转换为本地文件路径，兼容Windows系统
  const packageJsonPath = new URL(packageJsonUrl).pathname.replace(/^\/([A-Za-z]:)/, '$1');
  // 返回package.json所在的目录，即模块根目录
  return path.dirname(packageJsonPath);
}

// 使用示例
const luxonPath = await getModuleRootDir('luxon');
console.log(luxonPath);

说明 #

1. 解析规则匹配需求：import.meta.resolve()会自动按照Monorepo的模块查找顺序工作——pack1内有独立的luxon，会优先返回本地版本的路径；pack2没有本地安装，会向上找到根目录的luxon。
2. 路径兼容性：通过new URL().pathname处理URL到文件路径的转换，额外的正则替换是为了兼容Windows系统下的盘符格式（避免出现/C:/xxx这种错误路径）。
3. 异步特性：import.meta.resolve()是异步方法，因此需要配合async/await或.then()使用。

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