自定义 Rolldown 选项

tsdown 使用 Rolldown 作为其核心打包引擎。这使您可以轻松地直接向 Rolldown 传递或覆盖选项，从而对打包过程进行细粒度的控制。

有关可用 Rolldown 选项的完整列表，请参阅 Rolldown 配置选项 文档。

覆盖 inputOptions

您可以覆盖 tsdown 生成的 inputOptions，以自定义 Rolldown 如何处理输入文件。有两种方式可以实现：

使用对象

您可以直接传递一个对象来覆盖特定的 inputOptions：

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  inputOptions: {
    cwd: './custom-directory',
  },
})

在此示例中，cwd（当前工作目录）选项被设置为 ./custom-directory。

使用函数

或者，您可以使用一个函数动态修改 inputOptions。该函数接收生成的 inputOptions 和当前的 format 作为参数：

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  inputOptions(inputOptions, format) {
    inputOptions.cwd = './custom-directory'
    return inputOptions
  },
})

当您需要根据输出格式或其他动态条件自定义选项时，此方法非常有用。

覆盖 outputOptions

outputOptions 可以以与 inputOptions 相同的方式进行自定义。例如：

使用对象

您可以直接传递一个对象来覆盖特定的 outputOptions：

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  outputOptions: {
    comments: 'preserve-legal',
  },
})

在此示例中，comments: 'preserve-legal' 选项确保法律注释（例如许可证头部）会保留在输出文件中。

使用函数

您还可以使用一个函数动态修改 outputOptions。该函数接收生成的 outputOptions 和当前的 format 作为参数：

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  outputOptions(outputOptions, format) {
    if (format === 'esm') {
      outputOptions.comments = 'preserve-legal'
    }
    return outputOptions
  },
})

此方法确保仅对 esm 格式保留法律注释。

何时使用自定义选项

虽然 tsdown 直接暴露了许多常用选项，但在某些情况下，某些 Rolldown 选项可能未被暴露。在这种情况下，您可以使用 inputOptions 和 outputOptions 覆盖来直接在 Rolldown 中设置这些选项。

TIP

使用 inputOptions 和 outputOptions 可以完全访问 Rolldown 的强大配置系统，让您能够超越 tsdown 直接暴露的选项，自定义您的构建过程。