import.meta.resolve 是 ES 模块中同步解析模块说明符为绝对 URL 的底层 API，不加载模块，仅用于路径解析，需 ESM 上下文及 Node.js ≥20.6.0，支持相对路径、第三方包、node: 等协议，返回 file:// URL，可配合 fs.stat 验证存在性。
import.meta.resolve 是 ES 模块规范中定义的底层能力，用于在运行时同步解析模块说明符（specifier）到其最终解析后的 URL（通常是 file:// 或 https:// 协议的绝对路径），但它不加载模块，只做路径解析。它在构建工具、插件系统、沙箱环境或调试场景中非常实用，尤其适合动态探测依赖模块在当前环境中的物理位置。
必须满足的运行前提
该 API 仅在 ES 模块上下文 中可用（即 .mjs 文件、package.json 中 type: "module" 的 .js 文件，或通过 node --experimental-import-meta-resolve 启动），且 Node.js 版本需 ≥ 20.6.0（稳定支持）或 ≥ 18.19.0（需启用 flag）。在浏览器中暂未标准化，不可用。
- 确保当前脚本是 ESM：检查文件扩展名或 package.json 的 type 字段
- Node.js 运行时需满足版本要求；旧版本会抛出 TypeError: import.meta.resolve is not a function
- 不能在 CommonJS（require）中直接调用 —— 需通过顶层 await 或动态 import() 包裹后间接使用
基础用法：解析相对与第三方依赖路径
传入模块说明符（如 './utils'、'lodash-es'、'node:fs'），返回一个 Promise
const lodashPath = await import.meta.resolve('lodash-es');
console.log(lodashPath); // file:///path/to/node_modules/lodash-es/index.js
const localPath = await import.meta.resolve('./config.js');
console.log(localPath); // file:///project/src/config.js
- 第三方包会解析到其入口文件（遵循 exports 字段、main、module 等规则）
- 相对路径基于当前模块的 URL 解析（不是 process.cwd()）
- 支持 data:、node: 等特殊协议，如 await import.meta.resolve('node:process') → 'node:process'
探测嵌套依赖或子路径的真实位置
当需要定位某个包的内部文件（如 'vue/dist/vue.esm-bundler.js' 或 'axios/lib/adapters/http.js'），可直接将完整说明符传入 resolve：
const esmVue = await import.meta.resolve('vue/dist/vue.esm-bundler.js');
const httpAdapter = await import.meta.resolve('axios/lib/adapters/http.js');
- 结果是真实磁盘路径（file://），可用于 fs.readFile、存在性校验或构建时分析
- 若解析失败（如路径不存在、exports 未导出），会抛出 Error: Cannot resolve module
- 注意：某些包可能使用 conditional exports 限制子路径访问，此时需确认其 package.json 的 exports 字段是否允许该路径
结合 fs.stat 判断模块是否存在并获取类型
resolve 只返回路径，不保证文件/目录存在。可搭配 fs.promises.stat 进一步验证：
import { stat } from 'fs/promises';
try {
const resolved = await import.meta.resolve('picomatch');
const info = await stat(resolved);
console.log('isFile:', info.isFile()); // true → 指向具体文件
console.log('isDirectory:', info.isDirectory()); // true → 如指向包根（无后缀导入）
} catch (err) {
console.error('Module not found or inaccessible:', err.message);
}
- 适用于编写模块健康检查、依赖扫描器或开发服务器的模块重写逻辑
- 注意 file:// URL 需用 url.fileURLToPath() 转为路径字符串再传给 fs（Node.js 中 fs API 不直接接受 file://）
- 示例转换：import { fileURLToPath } from 'url'; const pathStr = fileURLToPath(resolved);
