用途:位于 packages/prettier-compare/ 的对比工具,用于检查 Biome 与 Prettier 在代码格式化及格式化 IR 输出上的差异,通常在发布格式化器改动前使用。
前提:所有命令需在仓库根目录执行,以确保相对路径正确;使用 bun(该 CLI 是 Bun 脚本),并先安装依赖;始终加上 --rebuild,使 Biome WASM 包与当前 Rust 改动保持一致。
主要用法: 以 CLI 参数传入代码片段:bun packages/prettier-compare/bin/prettier-compare.js --rebuild 'const x={a:1,b:2}' 强制指定语言:bun packages/prettier-compare/bin/prettier-compare.js --rebuild -l ts 'const x: number = 1' 对比磁盘文件:bun packages/prettier-compare/bin/prettier-compare.js --rebuild -f src/example.tsx 从标准输入读取:echo 'const x = 1' | bun packages/prettier-compare/bin/prettier-compare.js --rebuild -l js
使用提示:无扩展名的代码用 -l/--language 让两个格式化器选择正确解析器;大样本或快照测试用 -f/--file;更多 CLI 细节参考 packages/prettier-compare/README.md,其更新需同步到此说明,并保留命令必须含 --rebuild 的硬性要求;作为 CLI 参数传入的代码片段用单引号以避免 shell 解析问题;作为 CLI 参数的 "\n" 不会被转义为换行,应写换行字面量或改用文件。
限制与规范:代码与输出中禁止使用表情符号(emoji),包括对比脚本、测试文件、输出及诊断消息;该工具可在只读/规划模式下运行,即使带 --rebuild 也仅重建 Biome WASM 包,不修改任何源文件。其他细节暂未提供。