Biome 2.6 升级:Tailwind v4 类名排序、Markdown 支持与 includes glob 的坑
Biome v2.6 把 Tailwind 类名排序切到 v4 语义,同时补上了 Markdown、SCSS、YAML 的解析与格式化。从 v2 升上来的项目,真正容易出事的是 includes 的 glob 语义。
- 发布说明:
- v2 升级指南:
Tailwind:useTailwindSortedClasses 改用 v4 排序语义
原 useSortedClasses 改名为 useTailwindSortedClasses,排序规则从 Tailwind v3 换成了 v4。v4 的设计系统里,CSS 文件中的变量会直接变成 Tailwind 类,所以 Biome 需要知道你的设计系统样式表在哪,否则拿不到自定义 token,排序结果只能按内置类名猜:
{
"tailwind": {
"stylesheet": "app/global.css"
}
}
tailwind 是新增的顶层配置。所有 Tailwind 规则统一按同一种方式识别类名字符串,覆盖 JSX、TSX、HTML、Vue、Svelte、Astro。
新增规则:
noTailwindRawColors:标记bg-danger这类裸颜色值,并提示改用设计系统里已有的颜色。noTailwindRestyledComponents:报告那些改动组件颜色、排版、间距、形状、动效的 utility。useTailwindStaticClassStrings:挡住动态拼出来的类名字符串(样式容易丢),建议改用clsx/cn。useTailwindShorthandClasses:提示可简写的类名。
注意 Tailwind 的自动启用现在要求 tailwindcss v4 及以上。
Markdown / SCSS / YAML
Markdown 解析器按 100% CommonMark 一致性实现,支持 GFM 扩展(任务项、表格、短链接)。格式化器与 Prettier 约 92% 兼容。frontmatter 要显式开启 markdown.parser.frontmatter;默认会格式化 frontmatter、HTML 和围栏代码块,用 markdown.formatter.formatEmbeds 关掉;对这三者的 lint/assist 默认关闭,用 markdown.analyzeEmbeds 打开。
{
"markdown": {
"parser": { "frontmatter": true },
"formatter": { "formatEmbeds": true },
"analyze": { "analyzeEmbeds": true }
}
}
SCSS 对官方测试套件兼容度 >90%,格式化开箱即用,现有 CSS lint 规则可直接作用于 SCSS 文件;循环和 mixin 里的部分场景目前还覆盖不到。YAML 解析器 100% 一致性,格式化器 100% 兼容 Prettier,linter 暂时只有一条规则,后续会补 nursery 规则,包括 GitHub workflows 的安全检查。
v2 的 includes:不再自动前置 **/
这是 monorepo 里最容易踩的一条:
- 旧 glob 引擎会给用户写的 glob 自动加
**/,src/**变成**/src/**,匹配范围过大;v2 不再前置。*也不再匹配路径分隔符/。 - 路径和 glob 相对配置文件,不是工作目录。
在 ui/ 下跑 npm run check、命中父级 biome.json 时,src/** 匹配不到 ui/src/main.tsx,得写全:
{
"files": {
"includes": ["ui/src/**"]
}
}
同批破坏性变更:rome.json → biome.json,// rome-ignore → // biome-ignore,ROME_BINARY → BIOME_BINARY,抑制注释格式为 // biome-ignore lint//: ;biome lsp-proxy 和 biome start 去掉 --config-path;ignore / include 由 includes 取代;linter 的 all 选项移除;assert 语法改为 with(import ... with { type: "json" });每条规则都有默认 severity,style 组规则默认不再报 error;package.json 的对象和数组一律多行,要恢复原样用 override json.formatter.expand = "auto";import 排序规则也变了。
配置错误不再静默
插件抛错会以 error 诊断上报并让退出码非零;配置错误不再被静默忽略,会在任何命令执行前检查;插件的 include glob 也改为相对配置文件匹配。
升级时先跑迁移,再整体检查:
npx @biomejs/biome migrate
npx @biomejs/biome check --write .