Prettier 的诞生：使用 Recast 进行 AST 遍历的初始原型工程

Prettier 作为一款 opinionated 的代码格式化工具，其核心价值在于通过自动化方式统一代码风格，避免团队内部因格式偏好引发的无谓争论。在初始原型阶段，开发者 Christopher Chedeau（Vjeux）借鉴了 gofmt 和 dartfmt 的经验，但针对 JavaScript 的复杂性，选择了 Recast 作为 AST 遍历的核心库。这种设计不仅确保了格式化的确定性和可预测性，还奠定了 Prettier 无配置哲学的基础。通过解析代码为抽象语法树（AST），Recast 允许开发者忽略原始格式的噪声，直接操作语义结构，从而生成一致的输出。

在工程实现上，Prettier 的原型利用 Recast 的 parse 和 print API 来处理输入代码。首先，parse 函数将源代码转换为 AST，同时保留必要的格式元数据，避免破坏性修改。随后，在遍历 AST 时，应用固定规则如缩进使用 2 个空格、单引号优先、无分号选项等。这些规则源于对 Facebook 大型代码库的统计分析，例如链式方法调用的换行阈值设置为 80 列以内单行，否则展开多行。这种数据驱动方法确保了规则的实用性，而非主观臆断。

证据显示，这种 AST 遍历策略在早期测试中表现出色。使用 Jest 的 snapshot 测试框架，开发者编写了数千个 JavaScript 文件作为测试用例，自动生成预期输出。通过 idempotency 检查——即 prettier(prettier(input)) === prettier(input)——验证了格式化的稳定性。在 Facebook 内部 rollout 时，运行全代码库测试仅发现零星正确性问题，如括号添加导致的语义微变，但通过 Recast 的 nondestructive 打印机制得以规避。Vjeux 在其博客中提到：“我们通过 grep 巨型代码库来决定格式选择，确保最常见模式优先。” 这不仅加速了原型迭代，还为后续多语言扩展（如 CSS、HTML）提供了模板。

尽管初始原型高效，但也面临风险，如注释处理的不完整性。Recast 默认使用 Esprima 解析器，对于内联注释或块注释的定位，需要额外 heuristics 来决定是否换行或缩进。另一个限制是性能：在嵌套对象字面量时，conditionalGroup 原始操作可能导致 O(n²) 时间复杂度，虽在实践中罕见，但建议监控大型文件格式化耗时。

为落地 Prettier 原型工程，提供以下可操作参数与清单：

1. 环境搭建参数：

   • Node.js 版本：≥ 10（兼容 Recast 早期 API）。
   • 依赖安装：npm install recast esprima prettier（Esprima 作为 Recast 默认解析器）。
   • 配置阈值：printWidth: 80（行宽上限），tabWidth: 2（缩进宽度），semi: false（无分号），singleQuote: true（单引号）。

2. AST 遍历集成清单：

   • 步骤1：导入 Recast，定义 parse：const ast = recast.parse(source, { parser: require('esprima') });。
   • 步骤2：自定义 visitor 遍历 AST，例如针对 MemberExpression 节点应用链式规则：如果深度 > 3，则插入 hardline 换行。
   • 步骤3：使用 print 生成输出：const output = recast.print(ast).code;。集成 prettier 规则覆盖，如函数参数展开阈值设为 4 个参数。
   • 步骤4：添加 @format 注解到文件首，支持渐进 rollout，避免全库重格式化冲突。

3. 监控与回滚策略：

   • 监控点：格式化后运行 ESLint 检查语义一致性；CI 中集成 diff 审查，仅允许 ≤5% 行变更。
   • 性能阈值：单文件格式化 < 100ms；若超标，fallback 到手动规则。
   • 回滚机制：保留原始 AST 元数据，便于 diff 比较；升级时分批 PR，优先低风险模块。

4. 扩展参数：

   • 对于 TypeScript 支持，切换 Recast parser 为 Babel：{ parser: require('@babel/parser') }，确保 Flow/Type 注解不丢失。
   • 边缘案例处理：链式方法中，设置 maxChainLength: 5；对象字面量若含换行，强制 expanded 形式。
   • 测试覆盖：目标 95% AST 节点，使用 snapshot 更新命令 jest --updateSnapshot 迭代规则。

这种原型设计的核心在于平衡简洁与鲁棒性。通过 Recast 的 AST 遍历，Prettier 避免了传统 linter 的规则冲突问题，转而采用声明式格式生成。实际部署中，团队可根据项目规模调整 printWidth（如移动端设为 60），并监控采用率：目标首月 50% 文件 @format 覆盖。长期来看，这种无配置方法显著降低了 onboarding 成本，新开发者无需纠结风格，直接聚焦业务逻辑。

在多模型协作场景下，Prettier 原型还可扩展到 monorepo：使用 glob 模式扫描 *.js 文件，批量应用规则。风险控制上，引入 dry-run 模式预览变更，避免生产事故。总体而言，Recast 驱动的初始工程不仅是技术创新，更是工程哲学的体现——用固定规则解放生产力。（字数：1028）