⚙️ 一般配置

本页收录 6 个配置项，来源于 UserDefinedOptions。

配置一览

配置项	类型	默认值	说明
cssSourceTrace	CssSourceTraceUserOptions	false	在输出 CSS 中为工具类规则标注 token 来源文件。
babelParserOptions	(Partial & { cache?: boolean | undefined; cacheKey?: string | undefined; cacheMaxEntries?: number | undefined; cacheMaxSourceLength?: number | undefined; })	—	@babel/parser 的配置选项。
experimentalJsFastPath	boolean | "oxc"	—	实验性 JS 转译快路径。
postcssOptions	Partial<Omit<Result, "file">>	—	postcss 的配置选项。
tailwindcssRuntimeOptions	TailwindCssRuntimeOptions	—	自定义 Tailwind CSS 运行时参数。
logLevel	"info" | "warn" | "error" | "silent"	—	控制命令行日志输出级别。

详细说明

cssSourceTrace

可选 | 类型: CssSourceTraceUserOptions | 默认值: false

在输出 CSS 中为工具类规则标注 token 来源文件。

备注

默认关闭。开启后会在生成的 CSS 规则前插入 tokens: token <= source-file 注释， 用于排查某条工具类来自哪个源码文件。可传入 { root } 控制注释里的相对路径基准。 该能力面向调试与 demo 验收，生产构建通常保持关闭以减少产物体积。

默认值

false

babelParserOptions

可选 | 类型: (Partial<Options> & { cache?: boolean | undefined; cacheKey?: string | undefined; cacheMaxEntries?: number | undefined; cacheMaxSourceLength?: number | undefined; }) | 版本: ^3.2.0

@babel/parser 的配置选项。

experimentalJsFastPath

可选 | 类型: boolean | "oxc"

实验性 JS 转译快路径。

备注

当前仅在调用侧关闭 source map，且没有模块图、模块替换、ignore 调用/标签模板语义时尝试 OXC。 OXC npm 包本身要求 Node ^20.19.0 || >=22.12.0，Node 18 环境会自动回退到 Babel。

postcssOptions

可选 | 类型: Partial<Omit<Result, "file">> | 版本: ^3.2.0

postcss 的配置选项。

tailwindcssRuntimeOptions

可选 | 类型: TailwindCssRuntimeOptions

自定义 Tailwind CSS 运行时参数。

logLevel

可选 | 类型: "info" | "warn" | "error" | "silent"

控制命令行日志输出级别。

备注

默认 info，可设置为 silent 屏蔽全部输出。