给定基础路径，ES模块如何实现createRequire.resolve的等效功能？

云原生阿岚

2026-6-29

"exports": {
".": {
"types": "./index.d.ts",
"import": "./esm/index.js", // ES模块
"default": "./index.js" // CommonJS模块，上述函数会返回这个路径
},
},
...

我了解有`import.meta.resolve()`，但它无法设置解析的基础路径，其解析路径相对位于完全不同目录的插桩脚本。

请问给定基础路径时，ES模块中解析模块名称的等效方法是什么？

---

# 解决方案

### 方法1：给`require.resolve`指定`import`条件
直接复用`createRequire`的逻辑，通过添加`conditions`选项强制解析ES模块路径：
```js
const { createRequire } = require('module');

function resolveEsModule(currentFilePath, moduleName) {
  const requireFunc = createRequire(currentFilePath);
  return requireFunc.resolve(moduleName, {
    conditions: ['import']
  });
}

这个方案同步、高效，完全适配插桩场景——你只需要路径，不需要加载模块，所以无需切换到ES模块的异步API。

方法2：用`import.meta.resolve`结合文件URL

如果偏好ES模块原生API，可以通过构造file: URL指定解析基础路径：

import { fileURLToPath, pathToFileURL } from 'url';

async function resolveEsModule(currentFilePath, moduleName) {
  const baseUrl = pathToFileURL(currentFilePath).href;
  const resolvedUrl = await import.meta.resolve(moduleName, baseUrl);
  return fileURLToPath(resolvedUrl);
}

注意此方法为异步，若你的插桩流程是同步的，需要调整逻辑适配异步调用。

方法3：Node.js 18+ 内置`module.resolve`

Node.js 18及以上版本提供了原生同步的ES模块解析方法，支持指定基础路径和解析条件：

const { resolve } = require('module');
const { fileURLToPath } = require('url');

function resolveEsModule(currentFilePath, moduleName) {
  const resolvedUrl = resolve(moduleName, {
    paths: [currentFilePath],
    conditions: ['import']
  });
  return fileURLToPath(resolvedUrl);
}

这是当前最原生、适配性最好的同步方案。