Conform.nvim 格式化器配置变更解析：从嵌套列表到 stop_after_first 的演进

在 Conform.nvim 0.10.1 版本中，格式化器配置语法经历了一次重要变更。原本通过嵌套列表实现的复杂格式化流程控制，现在被更直观的 stop_after_first 参数所取代。这一变更虽然简化了大多数场景的配置，但也带来了某些特殊配置场景的表达限制。

新旧配置语法对比

传统嵌套列表语法

formatters_by_ft = {
  python = { "ruff_fix", { "ruff_format", "black" } }
}

这种语法表示：

1. 总是执行 ruff_fix 格式化器
2. 然后执行 ruff_format 或 black 中的任意一个（类似或关系）

新式 stop_after_first 语法

formatters_by_ft = {
  python = { "ruff_fix", "ruff_format", "black", stop_after_first = true }

这种语法表示：

1. 按顺序尝试执行格式化器
2. 遇到第一个成功执行的格式化器后即停止

语义差异分析

关键区别在于：

• 旧语法允许将格式化器分组，部分总是执行，部分按条件执行
• 新语法对整个列表应用统一的"首次成功即停止"策略

对于示例中的 Python 格式化需求：

• 必须执行 ruff_fix
• 选择性执行 ruff_format 或 black

新语法无法精确表达这种"部分必须+部分可选"的组合逻辑。

解决方案与最佳实践

虽然核心语法有所变化，但通过组合配置仍可实现类似效果：

1. 分阶段格式化：将必须执行的格式化器放在单独的自动命令中
2. 自定义格式化函数：通过 Lua 函数实现更复杂的逻辑控制
3. 条件格式化：利用文件类型检测或其他条件决定执行哪些格式化器

这种演进反映了配置设计从复杂特殊语法向简单统一接口的发展趋势。虽然某些边缘场景的表达力有所减弱，但提高了大多数情况下的可读性和可维护性。

对于需要精确控制格式化流程的高级用户，建议：

• 理解新旧语法的核心差异
• 评估是否真的需要复杂的格式化组合
• 必要时使用自定义函数实现特定需求