{ // ⚠️ 本文件只是**两道闸中的一道**:biome 挡得住 biome,挡不住 prettier。 // 真正的总开关是根目录的 `.pi-lens.json`(两条改写路径一起关), // 而它**必须是严格 JSON** —— 带 // 注释会被 pi-lens 整份忽略、防护静默失效。 // 完整来龙去脉见 docs/DEV-TOOLING.md。 // // 本仓库**不使用** biome 的格式化器,只借它做诊断(且由 pi-lens 统一调度)。 // // # 为什么显式关闭 // // pi-lens 内置「安全格式化」,会对编辑过的文件跑 // `biome format --write`(沿 biome 标准向上查找配置)。本机没有任何 // biome 配置时,biome 用它自己的默认值:**tab 缩进 + 双引号**。 // // 本仓库的手工排版与那套默认不兼容:注释按语义换行、数组与调用按可读性 // 手工折行,长注释常超过 100 列。实测把缩进/引号/lineWidth 全部对齐到本仓库 // 习惯之后,`biome format --write` 仍然改动 17 个文件 —— 也就是说只要格式化器 // 开着,每次编辑都会产生与内容无关的大面积 diff,把真正的改动埋掉。 // // 曾经发生过:一次 `git add -A` 把约 7000 行纯重排扫进了功能提交 // (19a3161),使那次提交无法审查 —— 还掩盖了一处 Go 文件的删行。 // // # 因此 // // - formatter 关闭:保持本仓库既有排版,不再产生重排噪声 // - linter 关闭:`biome lint --write` 会做自动修复,同样会改到与本次改动 // 无关的行;本仓库的静态检查由 pi-lens 的其它 runner(tsc / tree-sitter / // ast-grep / go vet)与各自的测试套件承担 // // 新文件仍应遵守本仓库的既有风格(2 空格缩进、单引号)。 "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true }, "formatter": { "enabled": false }, "linter": { "enabled": false } }