配置VS Code默认使用Biome后CLI与编辑器格式化结果不一致问题

以下是几个可能的原因和对应的排查/解决步骤：

• Biome版本不匹配
  CLI和VS Code扩展使用的Biome版本不同，是导致行为不一致的常见原因。执行npx @biomejs/biome --version查看CLI版本，再打开VS Code扩展面板找到Biome扩展，查看其版本号。如果两者不一致，要么升级CLI（npm install @biomejs/biome --save-dev），要么在VS Code里更新Biome扩展，确保版本统一。

• 项目Biome配置文件问题
  检查项目根目录是否存在biome.json或biome.jsonc配置文件。CLI会严格读取项目根目录的配置，而VS Code扩展如果找不到根目录配置，可能会 fallback 到默认配置或其他层级的配置。确认配置文件中的formatter、linter规则完全一致，比如是否开启了相同的格式化选项（如缩进、引号风格），有没有针对特定文件的规则例外。

• VS Code配置冲突
  即使你设置了工作区的editor.defaultFormatter，用户级配置可能会覆盖它。打开VS Code设置（Ctrl+,），搜索defaultFormatter，确认工作区配置的biomejs.biome处于生效状态（用户级配置如果有值，可能需要暂时禁用）。另外，检查editor.codeActionsOnSave中是否有其他工具的source.fixAll配置（比如ESLint），可以添加"source.fixAll.eslint": false来避免冲突。

• VS Code扩展缓存或加载问题
  有时候VS Code扩展会缓存旧的配置或规则，导致和CLI行为不一致。尝试重新加载VS Code窗口（Ctrl+Shift+P -> 选择"Reload Window"），或者禁用再重新启用Biome扩展，让它重新读取配置文件。

• 文件类型关联错误
  确认VS Code将你处理的文件类型（如.js、.ts、.vue等）正确关联到Biome扩展。在设置中搜索files.associations，检查有没有其他工具（比如Prettier）关联了这些文件类型，如果有，删除对应的关联规则。

内容的提问来源于stack exchange，提问作者Ole