Oxc

Oxfmt 配置选项 ​

大多数选项与 Prettier 的选项相同，但并非全部。 此外，一些选项是我们自己的扩展。

arrowParens ​

类型："always" | "avoid"

在唯一的箭头函数参数周围包含括号。

  • 默认值："always"

bracketSameLine ​

类型：boolean

将多行 HTML（HTML、JSX、Vue、Angular）元素的 > 放在最后一行的末尾，而不是单独放在下一行（不适用于自闭合元素）。

  • 默认值：false

bracketSpacing ​

类型：boolean

在对象字面量中的括号之间打印空格。

  • 默认值：true

embeddedLanguageFormatting ​

类型："auto" | "off"

控制是否格式化文件中的嵌入部分（例如，CSS-in-JS 或 JS-in-Vue 等）。

注意：XXX-in-JS 支持不完整。

  • 默认值："auto"

endOfLine ​

类型："lf" | "crlf" | "cr"

应用哪种行尾字符。

注意：不支持 "auto"。

  • 默认值："lf"
  • 覆盖 .editorconfig.end_of_line

htmlWhitespaceSensitivity ​

类型："css" | "strict" | "ignore"

指定 HTML、Vue、Angular 和 Handlebars 的全局空白敏感性。

  • 默认值："css"

ignorePatterns ​

类型：string[]

忽略匹配这些 glob 模式的文件。 模式基于 Oxfmt 配置文件的位置。

  • 默认值：[]

insertFinalNewline ​

类型：boolean

是否在文件末尾插入最终换行符。

  • 默认值：true
  • 覆盖 .editorconfig.insert_final_newline

jsdoc ​

类型：object | boolean

启用 JSDoc 注释格式化。

启用后，JSDoc 注释会被规范化和重新格式化： 标签别名被规范化，描述被大写化， 长行被换行，短注释被折叠为单行。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用

jsdoc.addDefaultToDescription ​

类型：boolean

将默认值附加到 @param 描述（例如 "Default is value"）。

  • 默认值：true

jsdoc.bracketSpacing ​

类型：boolean

在 JSDoc 类型括号内添加空格：{string} → { string }。

  • 默认值：false

jsdoc.capitalizeDescriptions ​

类型：boolean

将标签描述的首字母大写。

  • 默认值：true

jsdoc.commentLineStrategy ​

类型：string

如何格式化注释块。

  • "singleLine" — 在可能时转换为单行 /** content */。

  • "multiline" — 始终使用多行格式。

  • "keep" — 保留原始格式。

  • 默认值："singleLine"

jsdoc.descriptionTag ​

类型：boolean

输出 @description 标签而不是内联描述。

  • 默认值：false

jsdoc.descriptionWithDot ​

类型：boolean

在描述末尾添加尾随点。

  • 默认值：false

jsdoc.keepUnparsableExampleIndent ​

类型：boolean

在无法解析的 @example 代码中保留缩进。

  • 默认值：false

jsdoc.lineWrappingStyle ​

类型：string

在打印宽度处换行描述行的策略。

  • "greedy" — 总是重新换行文本以适应打印宽度。

  • "balance" — 如果所有行都在打印宽度内，则保留原始换行。

  • 默认值："greedy"

jsdoc.preferCodeFences ​

类型：boolean

对没有语言标签的代码使用围栏代码块（```）而不是 4 空格缩进。

  • 默认值：false

jsdoc.separateReturnsFromParam ​

类型：boolean

在最后一个 @param 和 @returns 之间添加空行。

  • 默认值：false

jsdoc.separateTagGroups ​

类型：boolean

在不同标签组之间添加空行（例如 @param 和 @returns 之间）。

  • 默认值：false

jsxSingleQuote ​

类型：boolean

在 JSX 中使用单引号而不是双引号。

  • 默认值：false

objectWrap ​

类型："preserve" | "collapse"

当对象字面量可以放在一行或跨越多行时如何换行。

默认情况下，如果在第一个属性之前有换行符，则将对象格式化为多行。 作者可以使用此启发式方法来根据上下文提高可读性，尽管它有一些缺点。

  • 默认值："preserve"

overrides ​

类型：array

文件特定覆盖。 当文件匹配多个覆盖时，后面的覆盖优先（数组顺序很重要）。

  • 默认值：[]

overrides[n] ​

类型：object

overrides[n].excludeFiles ​

类型：string[]

从此覆盖中排除的 glob 模式。

overrides[n].files ​

类型：string[]

匹配此覆盖文件的 glob 模式。 所有模式都相对于 Oxfmt 配置文件。

overrides[n].options ​

类型：object

overrides[n].options.arrowParens ​

类型："always" | "avoid"

在唯一的箭头函数参数周围包含括号。

  • 默认值："always"
overrides[n].options.bracketSameLine ​

类型：boolean

将多行 HTML（HTML、JSX、Vue、Angular）元素的 > 放在最后一行的末尾，而不是单独放在下一行（不适用于自闭合元素）。

  • 默认值：false
overrides[n].options.bracketSpacing ​

类型：boolean

在对象字面量中的括号之间打印空格。

  • 默认值：true
overrides[n].options.embeddedLanguageFormatting ​

类型："auto" | "off"

控制是否格式化文件中的嵌入部分（例如，CSS-in-JS 或 JS-in-Vue 等）。

注意：XXX-in-JS 支持不完整。

  • 默认值："auto"
overrides[n].options.endOfLine ​

类型："lf" | "crlf" | "cr"

应用哪种行尾字符。

注意：不支持 "auto"。

  • 默认值："lf"
  • 覆盖 .editorconfig.end_of_line
overrides[n].options.htmlWhitespaceSensitivity ​

类型："css" | "strict" | "ignore"

指定 HTML、Vue、Angular 和 Handlebars 的全局空白敏感性。

  • 默认值："css"
overrides[n].options.insertFinalNewline ​

类型：boolean

是否在文件末尾插入最终换行符。

  • 默认值：true
  • 覆盖 .editorconfig.insert_final_newline
overrides[n].options.jsdoc ​

类型：object | boolean

启用 JSDoc 注释格式化。

启用后，JSDoc 注释会被规范化和重新格式化： 标签别名被规范化，描述被大写化， 长行被换行，短注释被折叠为单行。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用
overrides[n].options.jsdoc.addDefaultToDescription ​

类型：boolean

将默认值附加到 @param 描述（例如 "Default is value"）。

  • 默认值：true
overrides[n].options.jsdoc.bracketSpacing ​

类型：boolean

在 JSDoc 类型括号内添加空格：{string} → { string }。

  • 默认值：false
overrides[n].options.jsdoc.capitalizeDescriptions ​

类型：boolean

将标签描述的首字母大写。

  • 默认值：true
overrides[n].options.jsdoc.commentLineStrategy ​

类型：string

如何格式化注释块。

  • "singleLine" — 在可能时转换为单行 /** content */。

  • "multiline" — 始终使用多行格式。

  • "keep" — 保留原始格式。

  • 默认值："singleLine"

overrides[n].options.jsdoc.descriptionTag ​

类型：boolean

输出 @description 标签而不是内联描述。

  • 默认值：false
overrides[n].options.jsdoc.descriptionWithDot ​

类型：boolean

在描述末尾添加尾随点。

  • 默认值：false
overrides[n].options.jsdoc.keepUnparsableExampleIndent ​

类型：boolean

在无法解析的 @example 代码中保留缩进。

  • 默认值：false
overrides[n].options.jsdoc.lineWrappingStyle ​

类型：string

在打印宽度处换行描述行的策略。

  • "greedy" — 总是重新换行文本以适应打印宽度。

  • "balance" — 如果所有行都在打印宽度内，则保留原始换行。

  • 默认值："greedy"

overrides[n].options.jsdoc.preferCodeFences ​

类型：boolean

对没有语言标签的代码使用围栏代码块（```）而不是 4 空格缩进。

  • 默认值：false
overrides[n].options.jsdoc.separateReturnsFromParam ​

类型：boolean

在最后一个 @param 和 @returns 之间添加空行。

  • 默认值：false
overrides[n].options.jsdoc.separateTagGroups ​

类型：boolean

在不同标签组之间添加空行（例如 @param 和 @returns 之间）。

  • 默认值：false
overrides[n].options.jsxSingleQuote ​

类型：boolean

在 JSX 中使用单引号而不是双引号。

  • 默认值：false
overrides[n].options.objectWrap ​

类型："preserve" | "collapse"

当对象字面量可以放在一行或跨越多行时如何换行。

默认情况下，如果在第一个属性之前有换行符，则将对象格式化为多行。 作者可以使用此启发式方法来根据上下文提高可读性，尽管它有一些缺点。

  • 默认值："preserve"
overrides[n].options.printWidth ​

类型：integer

指定打印机换行的行长度。

如果你不想在格式化 Markdown 时换行，可以设置 proseWrap 选项来禁用它。

  • 默认值：100
  • 覆盖 .editorconfig.max_line_length
overrides[n].options.proseWrap ​

类型："always" | "never" | "preserve"

如何换行散文。

默认情况下，格式化器不会改变 markdown 文本中的换行，因为某些服务使用换行敏感的渲染器，例如 GitHub 评论和 BitBucket。 要将散文换行到打印宽度，将此选项更改为 "always"。 如果你想强制所有散文块在单行上并依赖编辑器/查看器的软换行，可以使用 "never"。

  • 默认值："preserve"
overrides[n].options.quoteProps ​

类型："as-needed" | "consistent" | "preserve"

更改对象中属性何时被引用。

  • 默认值："as-needed"
overrides[n].options.semi ​

类型：boolean

在语句末尾打印分号。

  • 默认值：true
overrides[n].options.singleAttributePerLine ​

类型：boolean

在 HTML、Vue 和 JSX 中强制每行单个属性。

  • 默认值：false
overrides[n].options.singleQuote ​

类型：boolean

使用单引号而不是双引号。

对于 JSX，你可以设置 jsxSingleQuote 选项。

  • 默认值：false
  • 覆盖 .editorconfig.quote_type
overrides[n].options.sortImports ​

类型：object | boolean

排序 import 语句。

使用与 eslint-plugin-perfectionist/sort-imports 类似的算法。 详情请参阅各字段文档。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用
overrides[n].options.sortImports.customGroups ​

类型：array

定义自己的组以匹配非常特定的导入。

customGroups 列表是有序的：第一个匹配元素的定义将被使用。 自定义组比任何预定义组具有更高的优先级。

如果你希望预定义组优先于自定义组， 你必须编写一个与预定义组相同功能的自定义组定义，并将其放在列表首位。

如果你指定多个条件如 elementNamePattern、selector 和 modifiers， 所有条件必须都满足才能让导入匹配自定义组（AND 逻辑）。

  • 默认值：[]

####### overrides[n].options.sortImports.customGroups[n]

类型：object

######## overrides[n].options.sortImports.customGroups[n].elementNamePattern

类型：string[]

默认值：[]

匹配此组导入源的 glob 模式列表。

######## overrides[n].options.sortImports.customGroups[n].groupName

类型：string

默认值：""

自定义组的名称，用于 groups 选项。

######## overrides[n].options.sortImports.customGroups[n].modifiers

类型：string[]

匹配导入特征的修饰符。 所有指定的修饰符都必须存在（AND 逻辑）。

可选值："side_effect"、"type"、"value"、"default"、"wildcard"、"named"

######## overrides[n].options.sortImports.customGroups[n].selector

类型：string

匹配导入类型的选择器。

可选值："type"、"side_effect_style"、"side_effect"、"style"、"index"、 "sibling"、"parent"、"subpath"、"internal"、"builtin"、"external"、"import"

overrides[n].options.sortImports.groups ​

类型：array

指定用于排序的预定义导入组列表。

每个导入将被分配到 groups 选项中指定的单个组（如果未找到匹配则为 unknown 组）。 groups 选项中项目的顺序决定了组的排序方式。

在给定组内，成员将根据 type、order、ignoreCase 等选项进行排序。

单个组可以通过将它们放在数组中来组合在一起。 该数组中组的顺序不重要。 数组中所有组的成员将作为一个单一组一起排序。

预定义组由单个选择器和可能的多个修饰符特征化。 你可以以任何顺序输入修饰符，但选择器必须始终在最后。

选择器列表按重要性从高到低排序：

  • type — TypeScript 类型导入。
  • side_effect_style — 副作用样式导入。
  • side_effect — 副作用导入。
  • style — 样式导入。
  • index — 当前目录的主文件。
  • sibling — 来自同一目录的模块。
  • parent — 来自父目录的模块。
  • subpath — Node.js 子路径导入。
  • internal — 你的内部模块。
  • builtin — Node.js 内置模块。
  • external — 项目中安装的外部模块。
  • import — 任何导入。

修饰符列表按重要性从高到低排序：

  • side_effect — 副作用导入。

  • type — TypeScript 类型导入。

  • value — 值导入。

  • default — 包含默认说明符的导入。

  • wildcard — 包含通配符（* as）说明符的导入。

  • named — 包含至少一个命名说明符的导入。

  • 默认值：见下方

json
["builtin", "external", ["internal", "subpath"], ["parent", "sibling", "index"], "style", "unknown"]

此外，你可以通过在 groups 列表的所需位置包含 { "newlinesBetween": boolean } 标记对象来覆盖特定组边界的全局 newlinesBetween 设置。

####### overrides[n].options.sortImports.groups[n]

类型：object | array | string

######## overrides[n].options.sortImports.groups[n].newlinesBetween

类型：boolean

overrides[n].options.sortImports.ignoreCase ​

类型：boolean

指定排序是否应该区分大小写。

  • 默认值：true
overrides[n].options.sortImports.internalPattern ​

类型：string[]

指定用于识别内部导入的前缀。

这对于区分你自己的模块和外部依赖很有用。

  • 默认值：["~/", "@/"]
overrides[n].options.sortImports.newlinesBetween ​

类型：boolean

指定是否在组之间添加换行。

当 false 时，不在组之间添加换行。

  • 默认值：true
overrides[n].options.sortImports.order ​

类型："asc" | "desc"

指定按升序还是降序排序项目。

  • 默认值："asc"
overrides[n].options.sortImports.partitionByComment ​

类型：boolean

启用使用注释将导入分隔为逻辑组。

当 true 时，所有注释将被视为分隔符，创建分区。

js
import { b1, b2 } from "b";
// PARTITION
import { a } from "a";
import { c } from "c";
  • 默认值：false
overrides[n].options.sortImports.partitionByNewline ​

类型：boolean

启用空行将导入分隔为逻辑组。

当 true 时，如果导入之间有空行，格式化器不会排序导入。 这有助于维护逻辑分隔成员组的定义顺序。

js
import { b1, b2 } from "b";

import { a } from "a";
import { c } from "c";
  • 默认值：false
overrides[n].options.sortImports.sortSideEffects ​

类型：boolean

指定是否应该排序副作用导入。

默认情况下，出于安全原因，排序副作用导入是禁用的。

  • 默认值：false
overrides[n].options.sortPackageJson ​

类型：object | boolean

排序 package.json 键。

该算法与 prettier-plugin-sort-packagejson 不兼容。 但我们相信它更清晰且更容易导航。 详情请参阅各字段文档。

  • 默认值：true
overrides[n].options.sortPackageJson.sortScripts ​

类型：boolean

按字母顺序排序 scripts 字段。

  • 默认值：false
overrides[n].options.sortTailwindcss ​

类型：object | boolean

排序 Tailwind CSS 类。

使用与 prettier-plugin-tailwindcss 相同的算法。 选项名称省略了原插件中使用的 tailwind 前缀（例如，用 config 代替 tailwindConfig）。 详情请参阅各字段文档。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用
overrides[n].options.sortTailwindcss.attributes ​

类型：string[]

除 class 和 className 外要排序的附加属性列表（精确匹配）。

注意：尚不支持正则表达式模式。

  • 默认值：[]
  • 示例：["myClassProp", ":class"]
overrides[n].options.sortTailwindcss.config ​

类型：string

Tailwind CSS 配置文件路径（v3）。

注意：路径相对于 Oxfmt 配置文件解析。

  • 默认值：自动查找 "tailwind.config.js"
overrides[n].options.sortTailwindcss.functions ​

类型：string[]

其参数应被排序的自定义函数名列表（精确匹配）。

注意：尚不支持正则表达式模式。

  • 默认值：[]
  • 示例：["clsx", "cn", "cva", "tw"]
overrides[n].options.sortTailwindcss.preserveDuplicates ​

类型：boolean

保留重复类。

  • 默认值：false
overrides[n].options.sortTailwindcss.preserveWhitespace ​

类型：boolean

保留类周围的空白。

  • 默认值：false
overrides[n].options.sortTailwindcss.stylesheet ​

类型：string

Tailwind CSS 样式表路径（v4）。

注意：路径相对于 Oxfmt 配置文件解析。

  • 默认值：已安装 Tailwind CSS 的 theme.css
overrides[n].options.tabWidth ​

类型：integer

指定每个缩进级别的空格数。

  • 默认值：2
  • 覆盖 .editorconfig.indent_size（回退到 .editorconfig.tab_width）
overrides[n].options.trailingComma ​

类型："all" | "es5" | "none"

在多行逗号分隔的语法结构中尽可能打印尾随逗号。

例如，单行数组永远不会得到尾随逗号。

  • 默认值："all"
overrides[n].options.useTabs ​

类型：boolean

用制表符而不是空格缩进行。

  • 默认值：false
  • 覆盖 .editorconfig.indent_style
overrides[n].options.vueIndentScriptAndStyle ​

类型：boolean

是否缩进 Vue 文件中 <script> 和 <style> 标签内的代码。

  • 默认值：false

printWidth ​

类型：integer

指定打印机换行的行长度。

如果你不想在格式化 Markdown 时换行，可以设置 proseWrap 选项来禁用它。

  • 默认值：100
  • 覆盖 .editorconfig.max_line_length

proseWrap ​

类型："always" | "never" | "preserve"

如何换行散文。

默认情况下，格式化器不会改变 markdown 文本中的换行，因为某些服务使用换行敏感的渲染器，例如 GitHub 评论和 BitBucket。 要将散文换行到打印宽度，将此选项更改为 "always"。 如果你想强制所有散文块在单行上并依赖编辑器/查看器的软换行，可以使用 "never"。

  • 默认值："preserve"

quoteProps ​

类型："as-needed" | "consistent" | "preserve"

更改对象中属性何时被引用。

  • 默认值："as-needed"

semi ​

类型：boolean

在语句末尾打印分号。

  • 默认值：true

singleAttributePerLine ​

类型：boolean

在 HTML、Vue 和 JSX 中强制每行单个属性。

  • 默认值：false

singleQuote ​

类型：boolean

使用单引号而不是双引号。

对于 JSX，你可以设置 jsxSingleQuote 选项。

  • 默认值：false
  • 覆盖 .editorconfig.quote_type

sortImports ​

类型：object | boolean

排序 import 语句。

使用与 eslint-plugin-perfectionist/sort-imports 类似的算法。 详情请参阅各字段文档。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用

sortImports.customGroups ​

类型：array

定义自己的组以匹配非常特定的导入。

customGroups 列表是有序的：第一个匹配元素的定义将被使用。 自定义组比任何预定义组具有更高的优先级。

如果你希望预定义组优先于自定义组， 你必须编写一个与预定义组相同功能的自定义组定义，并将其放在列表首位。

如果你指定多个条件如 elementNamePattern、selector 和 modifiers， 所有条件必须都满足才能让导入匹配自定义组（AND 逻辑）。

  • 默认值：[]

sortImports.customGroups[n] ​

类型：object

sortImports.customGroups[n].elementNamePattern ​

类型：string[]

默认值：[]

匹配此组导入源的 glob 模式列表。

sortImports.customGroups[n].groupName ​

类型：string

默认值：""

自定义组的名称，用于 groups 选项。

sortImports.customGroups[n].modifiers ​

类型：string[]

匹配导入特征的修饰符。 所有指定的修饰符都必须存在（AND 逻辑）。

可选值："side_effect"、"type"、"value"、"default"、"wildcard"、"named"

sortImports.customGroups[n].selector ​

类型：string

匹配导入类型的选择器。

可选值："type"、"side_effect_style"、"side_effect"、"style"、"index"、 "sibling"、"parent"、"subpath"、"internal"、"builtin"、"external"、"import"

sortImports.groups ​

类型：array

指定用于排序的预定义导入组列表。

每个导入将被分配到 groups 选项中指定的单个组（如果未找到匹配则为 unknown 组）。 groups 选项中项目的顺序决定了组的排序方式。

在给定组内，成员将根据 type、order、ignoreCase 等选项进行排序。

单个组可以通过将它们放在数组中来组合在一起。 该数组中组的顺序不重要。 数组中所有组的成员将作为一个单一组一起排序。

预定义组由单个选择器和可能的多个修饰符特征化。 你可以以任何顺序输入修饰符，但选择器必须始终在最后。

选择器列表按重要性从高到低排序：

  • type — TypeScript 类型导入。
  • side_effect_style — 副作用样式导入。
  • side_effect — 副作用导入。
  • style — 样式导入。
  • index — 当前目录的主文件。
  • sibling — 来自同一目录的模块。
  • parent — 来自父目录的模块。
  • subpath — Node.js 子路径导入。
  • internal — 你的内部模块。
  • builtin — Node.js 内置模块。
  • external — 项目中安装的外部模块。
  • import — 任何导入。

修饰符列表按重要性从高到低排序：

  • side_effect — 副作用导入。

  • type — TypeScript 类型导入。

  • value — 值导入。

  • default — 包含默认说明符的导入。

  • wildcard — 包含通配符（* as）说明符的导入。

  • named — 包含至少一个命名说明符的导入。

  • 默认值：见下方

json
["builtin", "external", ["internal", "subpath"], ["parent", "sibling", "index"], "style", "unknown"]

此外，你可以通过在 groups 列表的所需位置包含 { "newlinesBetween": boolean } 标记对象来覆盖特定组边界的全局 newlinesBetween 设置。

sortImports.groups[n] ​

类型：object | array | string

sortImports.groups[n].newlinesBetween ​

类型：boolean

sortImports.ignoreCase ​

类型：boolean

指定排序是否应该区分大小写。

  • 默认值：true

sortImports.internalPattern ​

类型：string[]

指定用于识别内部导入的前缀。

这对于区分你自己的模块和外部依赖很有用。

  • 默认值：["~/", "@/"]

sortImports.newlinesBetween ​

类型：boolean

指定是否在组之间添加换行。

当 false 时，不在组之间添加换行。

  • 默认值：true

sortImports.order ​

类型："asc" | "desc"

指定按升序还是降序排序项目。

  • 默认值："asc"

sortImports.partitionByComment ​

类型：boolean

启用使用注释将导入分隔为逻辑组。

当 true 时，所有注释将被视为分隔符，创建分区。

js
import { b1, b2 } from "b";
// PARTITION
import { a } from "a";
import { c } from "c";
  • 默认值：false

sortImports.partitionByNewline ​

类型：boolean

启用空行将导入分隔为逻辑组。

当 true 时，如果导入之间有空行，格式化器不会排序导入。 这有助于维护逻辑分隔成员组的定义顺序。

js
import { b1, b2 } from "b";

import { a } from "a";
import { c } from "c";
  • 默认值：false

sortImports.sortSideEffects ​

类型：boolean

指定是否应该排序副作用导入。

默认情况下，出于安全原因，排序副作用导入是禁用的。

  • 默认值：false

sortPackageJson ​

类型：object | boolean

排序 package.json 键。

该算法与 prettier-plugin-sort-packagejson 不兼容。 但我们相信它更清晰且更容易导航。 详情请参阅各字段文档。

  • 默认值：true

sortPackageJson.sortScripts ​

类型：boolean

按字母顺序排序 scripts 字段。

  • 默认值：false

sortTailwindcss ​

类型：object | boolean

排序 Tailwind CSS 类。

使用与 prettier-plugin-tailwindcss 相同的算法。 选项名称省略了原插件中使用的 tailwind 前缀（例如，用 config 代替 tailwindConfig）。 详情请参阅各字段文档。

传递 true 或对象以使用默认值启用，或省略/设置 false 以禁用。

  • 默认值：禁用

sortTailwindcss.attributes ​

类型：string[]

除 class 和 className 外要排序的附加属性列表（精确匹配）。

注意：尚不支持正则表达式模式。

  • 默认值：[]
  • 示例：["myClassProp", ":class"]

sortTailwindcss.config ​

类型：string

Tailwind CSS 配置文件路径（v3）。

注意：路径相对于 Oxfmt 配置文件解析。

  • 默认值：自动查找 "tailwind.config.js"

sortTailwindcss.functions ​

类型：string[]

其参数应被排序的自定义函数名列表（精确匹配）。

注意：尚不支持正则表达式模式。

  • 默认值：[]
  • 示例：["clsx", "cn", "cva", "tw"]

sortTailwindcss.preserveDuplicates ​

类型：boolean

保留重复类。

  • 默认值：false

sortTailwindcss.preserveWhitespace ​

类型：boolean

保留类周围的空白。

  • 默认值：false

sortTailwindcss.stylesheet ​

类型：string

Tailwind CSS 样式表路径（v4）。

注意：路径相对于 Oxfmt 配置文件解析。

  • 默认值：已安装 Tailwind CSS 的 theme.css

tabWidth ​

类型：integer

指定每个缩进级别的空格数。

  • 默认值：2
  • 覆盖 .editorconfig.indent_size（回退到 .editorconfig.tab_width）

trailingComma ​

类型："all" | "es5" | "none"

在多行逗号分隔的语法结构中尽可能打印尾随逗号。

例如，单行数组永远不会得到尾随逗号。

  • 默认值："all"

useTabs ​

类型：boolean

用制表符而不是空格缩进行。

  • 默认值：false
  • 覆盖 .editorconfig.indent_style

vueIndentScriptAndStyle ​

类型：boolean

是否缩进 Vue 文件中 <script> 和 <style> 标签内的代码。

  • 默认值：false

© 2026 VoidZero Inc. and Oxc contributors.