Vale 3.9.4版本文件格式匹配逻辑变更解析

Vale是一款流行的文本校验工具，近期在3.9.4版本中对文件格式匹配逻辑进行了重要调整，这一变更影响了部分用户的现有配置。本文将深入分析这一变更的技术细节及其影响。

变更背景

在Vale 3.9.4之前版本中，当用户通过[formats]配置将某种文件格式映射到另一种格式时（例如erb = md），系统会将这些文件视为目标格式进行处理。这意味着针对目标格式的规则配置会自动应用于映射后的文件。

变更内容

3.9.4版本对这一行为进行了调整，现在系统会严格区分原始文件格式和映射后的目标格式。这一变更使得用户能够为原始格式和目标格式分别配置不同的校验规则，提供了更精细的控制能力。

实际影响

这一变更最直接的影响体现在配置语法上。以常见的Markdown文件校验为例：

旧版本配置方式：

[formats]
mdx = md

[*.md]
BasedOnStyles = Vale, Google

在新版本中，上述配置将不再对.mdx文件生效。用户需要明确指定所有需要应用规则的文件格式：

[formats]
mdx = md

[*.{md,mdx}]
BasedOnStyles = Vale, Google

解决方案

对于受影响的用户，有以下几种调整方案：

1. 使用通配符语法明确指定多个文件格式：

[*.{md,mdx,erb}]

2. 使用更宽泛的匹配模式（注意可能影响其他文件类型）：

[*]

3. 为不同格式分别配置规则（如需差异化处理）

最佳实践建议

1. 明确列出所有需要校验的文件格式，避免使用过于宽泛的匹配模式
2. 在团队内部文档中记录格式映射关系
3. 考虑为不同格式创建专门的规则配置，充分利用新版本提供的灵活性

版本升级注意事项

从3.9.3及以下版本升级时，建议：

1. 首先在测试环境验证现有配置
2. 检查校验结果是否有变化
3. 根据需要对配置文件进行调整
4. 更新相关文档说明

这一变更虽然短期内可能需要调整配置，但从长远来看提供了更强大和灵活的文件处理能力，使Vale能够更好地适应复杂的文档校验场景。