Vale项目中关于大小写替换规则的变更解析

在文本校验工具Vale的最新版本中，针对大小写敏感的替换规则(substitution)进行了重要调整。这项变更主要影响那些需要同时处理不同大小写形式的单词替换场景。

原有机制的问题

在早期版本中，当用户配置了ignorecase: true参数时，替换规则会尝试自动匹配原始文本的大小写形式。例如：

• 将"e-mail"替换为"email"
• 将"E-mail"替换为"Email"

这种机制虽然方便，但在处理特定专有名词时会产生问题。以技术文档中常见的"iOS"和"JavaScript"为例，这些术语有固定的大小写规范，自动转换大小写的功能反而会导致错误的修正建议。

新版本解决方案

Vale 3.4版本引入了新的capitalize配置项来更精确地控制大小写处理行为：

extends: substitution
message: "建议使用'%s'替代'%s'"
level: error
ignorecase: true
capitalize: true  # 新增的关键配置
action:
  name: replace
swap:
  e-mail: email

关键改进点

1. 分离关注点：将大小写匹配功能从ignorecase中独立出来，通过capitalize参数单独控制
2. 更精确的控制：用户可以自由选择是否需要保持原始文本的大小写特征
3. 兼容性考虑：既保留了原有的忽略大小写匹配功能，又增加了更细粒度的控制选项

实际应用建议

对于技术文档编写者，建议根据具体场景选择合适的配置：

1. 通用词汇替换（如email）：启用capitalize: true以保持大小写一致性
2. 专有名词替换（如iOS）：保持capitalize: false确保固定的大小写格式
3. 混合场景：可以为不同类型的词汇创建多个规则，分别配置不同的参数

这项改进体现了Vale项目对实际文档校验场景的深入理解，通过更精细化的配置选项，帮助用户在各种复杂情况下都能获得准确的文本修正建议。