Shims（兼容代码）

Shims 是一些小型代码片段，用于在不同的模块系统（如 CommonJS (CJS) 和 ECMAScript Modules (ESM)）之间提供兼容性。在 tsdown 中，shims 用于弥合这些系统之间的差异，确保您的代码能够在不同环境中顺畅运行。

ESM 中的 CommonJS 变量

在 CommonJS 中，__dirname 和 __filename 是内置变量，分别提供当前模块的目录路径和文件路径。然而，这些变量在 ESM 中默认不可用。

为了提高兼容性，当启用 shims 选项时，tsdown 会为 ESM 输出自动生成这些变量。例如：

console.log(__dirname) // 在启用 shims 时，ESM 中可用
console.log(__filename) // 在启用 shims 时，ESM 中可用

为 __dirname 和 __filename 生成的 shims 会引入极小的运行时开销。然而，如果您的代码中未使用这些变量，它们将在打包过程中被自动移除，确保不会包含不必要的代码。

即使未启用 shims 选项，tsdown 也会在 CommonJS 输出中自动生成以下 ESM 特定变量的 shims：

这些变量用于确保在 CommonJS 环境中使用 ESM 特性时的兼容性。例如：

console.log(import.meta.url)
console.log(import.meta.dirname)
console.log(import.meta.filename)

此行为在 CommonJS 输出中始终启用，因此您无需进行任何配置即可使用这些变量。

要在 ESM 输出中启用 __dirname 和 __filename 的 shims，可以在 CLI 中使用 --shims 选项，或在配置文件中设置 shims: true：

bash

tsdown --shims

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  shims: true,
})