用途:指导把项目从 Prettier 或 Biome 迁移到 Oxfmt——一款高性能、兼容 Prettier 的代码格式化器,多数 Prettier 选项可直接支持,并内置面向 Prettier 与 Biome 的自动迁移工具。
主要能力:自动查找当前目录的 Prettier 配置(package.json 的 prettier 字段、.prettierrc、.prettierrc.json、JS/TS 配置;解析共享配置;不支持 YAML、JSON5、TOML),生成 .oxfmtrc.json,迁移 overrides(parser 转 associations[].language)、.prettierignore 转 ignorePatterns,并迁移 tailwindcss、svelte、astro 插件选项及 sortPackageJson 检测。从 Biome 迁移可读取 biome.json/jsonc,映射两级配置(indentStyle→useTabs、indentWidth→tabWidth、lineWidth→printWidth、quoteStyle→singleQuote、semicolons→semi 等),未设置项按 Biome 默认值显式写入。
使用方式:npx oxfmt@latest --migrate prettier 或 npx oxfmt@latest --migrate biome;随后审查生成的 .oxfmtrc.json(注意 printWidth 默认差异、未支持选项、sortPackageJson、overrides),再更新 CI 与脚本命令为 npx oxfmt@latest 和 npx oxfmt@latest --check。其他命令:--list-different、--config、--ignore-path、--stdin-filepath、--init、--lsp,以及 --disable-nested-config。可用 $schema 指向 node_modules/oxfmt/configuration_schema.json。
限制:动态 JS/TS 配置只写入解析后的快照,逻辑需手动迁移;--migrate 不遍历子目录,嵌套配置需逐目录执行;已存在 Oxfmt 配置时会失败,需先删除;Biome overrides 无法自动迁移;endOfLine: "auto"、experimentalTernaries、requirePragma、insertPragma、顶层 parser 等不支持;run oxfmt 后配置可能尚未格式化。