Biome在VSCode不生效需检查五点:①biome.json必须位于工作区根目录;②内容至少含{"formatter":{"enabled":true}};③仅支持.json后缀,语法须合法;④开启editor.formatOnSave并确保语言模式正确;⑤禁用ESLint/Prettier格式化以避免冲突。

Biome在VSCode里不生效?先确认biome.json位置和内容
Biome不会自动扫描项目根目录以外的配置,如果biome.json不在你打开的文件夹根目录(或工作区根目录),它就完全不工作——连报错都不会有,只会静默退化成无格式化。
- 必须放在 VSCode 打开的最外层文件夹下,不是
src/或packages/子目录 -
biome.json至少要包含{"formatter": {"enabled": true}},否则格式化开关默认关着 - 别用
biome.jsonc:VSCode 的 Biome 插件目前只认.json后缀,用.jsonc会加载失败且无提示 - 检查
biome.json语法是否合法:JSON 不支持尾逗号、注释、单引号,用biome check biome.json验证最稳
保存时没触发格式化?检查editor.formatOnSave和语言模式
VSCode 默认不开启保存自动格式化,而且 Biome 只对明确识别为 JavaScript/TypeScript/JSX/TSX 的文件生效。如果你打开的是.js但右下角显示“Plain Text”,Biome 就压根不介入。
- 确保开启了
"editor.formatOnSave": true(推荐写在工作区设置.vscode/settings.json里) - 确认当前文件右下角语言模式是
JavaScript或TypeScript,不是JavaScript React或Plain Text;点一下切换,或按Ctrl+K M重设 - 如果用了
files.associations把.mjs映射成javascript,Biome 也能处理;但.cjs默认不识别,得手动加进biome.json的files.include
和 ESLint/Prettier 冲突?直接禁用它们的格式化能力
VSCode 同一时间只允许一个格式化器接管formatOnSave。Biome 和 ESLint(eslint.format.enable)或 Prettier(prettier.eslintIntegration等旧配置)共存时,会互相覆盖,结果不可预测——比如保存后代码被 Prettier 格式化一半,再被 Biome 覆盖,最终样式混乱。
- 在工作区
.vscode/settings.json中显式关闭:"eslint.format.enable": false、"prettier.enable": false - 删掉
prettier.*相关配置项(如prettier.semi),Biome 的formatter配置优先级更高,留着反而容易误导自己 - ESLint 仍可保留用于 lint 检查(
eslint.enable: true),只要不开启它的格式化,Biome 就只管格式,ESLint 只管报错,互不干扰
格式化结果和文档不一致?注意biome.json里的indentWidth和lineWidth
Biome 默认用 2 空格缩进、80 字符换行,但很多人习惯 4 空格或 100 宽度。改配置不难,但容易漏掉两个关键点:一是lineWidth影响 JSX 拆行逻辑,二是indentWidth必须是整数,填"2"(字符串)会静默失效。
-
"formatter": {"indentWidth": 4, "lineWidth": 100}—— 数值必须是数字,不是字符串 - 修改后需重启 VSCode 或重新加载窗口(
Ctrl+Shift+P→Developer: Reload Window),热更新不生效 - JSX 中长属性列表是否换行,取决于
lineWidth和当前行已有缩进量,不是单纯看字符数;调大lineWidth未必让所有 JSX 保持单行,这是设计使然
Biome 的格式化行为高度依赖配置文件的精确性,少一个逗号、错一个字段名、配错路径层级,都可能导致它彻底沉默——这种“无声失败”是最难排查的点。











