LECP 提供 shims 功能，实现 ESM 和 CommonJS 模块系统之间的变量兼容性支持，让开发者可以在任意模块系统中使用熟悉的语法。
这对以下场景特别有用：
__dirname、__filename、requireimport.meta.url、import.meta.dirname、import.meta.filename类型： boolean | { legacy?: boolean }
默认值： false
interface ShimsOptions {
/**
* 是否使用兼容模式
* @default false
*/
legacy?: boolean;
}| 配置 | Node.js 版本支持 | 实现方式 |
|---|---|---|
legacy: false (默认) | 20.11+ | 使用 import.meta.{dirname, filename} |
legacy: true | 10.12+ | 使用 fileURLToPath + createRequire |
在 ESM 产物中，可以直接使用 CJS 的全局变量：
// 在 ESM 模块中使用 CJS 变量
console.log(__dirname); // 当前目录路径
console.log(__filename); // 当前文件路径
// 动态导入 CJS 模块
const pkg = require('./package.json');// __dirname
console.log(import.meta.dirname);
// __filename
console.log(import.meta.filename);
// require
import { createRequire } from 'node:module';
const require = createRequire(import.meta.url);
const pkg = require('./package.json');// __dirname
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
// __filename
const __filename = fileURLToPath(import.meta.url);
// require
import { createRequire } from 'node:module';
const require = createRequire(import.meta.url);
const pkg = require('./package.json');在 CommonJS 产物中，可以使用 ESM 的 import.meta 变量：
// 在 CJS 模块中使用 ESM 变量
console.log(import.meta.url); // 文件 URL
console.log(import.meta.dirname); // 目录路径
console.log(import.meta.filename); // 文件路径// import.meta.url
console.log(require('url').pathToFileURL(__filename).toString());
// import.meta.dirname
console.log(__dirname);
// import.meta.filename
console.log(__filename);import { defineConfig } from '@shined/lecp';
export default defineConfig({
shims: true // 启用标准模式 (Node.js 20.11+)
});export default defineConfig({
shims: {
legacy: true // 支持较低版本 Node.js (10.12+)
}
});export default defineConfig({
format: [{ type: "esm" }, { type: "cjs" }],
shims: true,
targets: {
node: "20.11.0"
}
});更多详细配置请参考 配置文档。