Skip to content

运行平台(Platform)

运行平台指定了打包后 JavaScript 代码的目标运行环境。

默认情况下,tsdown 针对 node 运行时进行打包,但您可以通过 --platform 选项自定义目标平台:

bash
tsdown --platform node    # 默认
tsdown --platform browser
tsdown --platform neutral

可用平台

  • node: 针对 Node.js 运行时。这是默认平台,Node.js 内置模块(如 fspath)会被自动解析。适合工具链或服务端项目。
  • browser: 针对 Web 浏览器(如 Chrome、Firefox)。适用于前端项目。如果您的代码使用了 Node.js 内置模块,将会显示警告,您可能需要使用 polyfill 或 shim 来确保兼容性。
  • neutral: 一个与平台无关的目标,不对特定运行时环境做假设。如果您的代码需要在多个环境中运行,或者您希望完全控制运行时行为,可以选择此选项。特别适合用于 Node.js 和浏览器环境的库或共享代码。

示例

bash
# 针对 Node.js 打包(默认)
tsdown --platform node

# 针对浏览器打包
tsdown --platform browser

# 针对中立平台打包
tsdown --platform neutral

TIP

选择正确的平台可以确保您的代码针对目标运行时进行了优化。例如,前端项目使用 browser,服务端应用使用 node,而通用库使用 neutral

Released under the MIT License.