Vale项目中标题大小写规则的指标符使用问题解析

在Vale项目中，用户在使用capitalization规则时遇到了一个关于indicators参数与不同匹配模式配合使用的问题。本文将深入分析这一问题的技术背景、原因及解决方案。

问题现象

当用户使用Vale的capitalization规则检查标题大小写时，发现indicators参数在不同匹配模式下的行为不一致：

1. 使用$sentence匹配模式时，indicators能正确工作，在指定符号(如冒号)后的单词大小写不会被检查
2. 但使用$title匹配模式时，indicators似乎失效，指定符号后的单词仍会被检查大小写

技术分析

匹配模式的本质区别

$sentence和$title两种匹配模式在Vale中有本质区别：

• $sentence模式：检查是否符合句子大小写规则，即首字母大写，其余小写
• $title模式：检查是否符合标题大小写规则，即主要单词首字母大写

指标符的作用机制

indicators参数的设计初衷是标记文本中需要特殊处理的符号位置。但在不同匹配模式下，其作用效果确实存在差异：

1. 在$sentence模式下，指标符后的内容被视为新句子的开始，因此会检查首字母是否大写
2. 在$title模式下，指标符后的内容仍被视为标题的一部分，会继续应用标题大小写规则

实际应用场景

用户实际遇到的问题是希望在标题中忽略特定格式部分的大小写检查，例如：

### This Is My Heading {#my-anchor}

这里{#my-anchor}是用于标记锚点的特殊格式，用户希望这部分的小写不被视为错误。

解决方案

针对这类需求，Vale提供了更合适的解决方案：TokenIgnores参数。这个参数专门用于指定需要完全忽略的文本模式，不会影响其他部分的检查逻辑。

配置示例：

extends: capitalization
message: "'%s' should be in title case"
level: warning
scope: heading
match: $title
TokenIgnores:
    - '{#.*?}'

最佳实践建议

1. 对于需要完全忽略的特殊格式，优先使用TokenIgnores
2. indicators更适合用于标记文本中的逻辑分隔符
3. 理解不同匹配模式下的检查逻辑差异，选择合适的模式
4. 对于复杂的大小写检查需求，可以考虑组合使用多个规则

通过合理配置这些参数，可以精确控制Vale对文本大小写的检查行为，满足各种复杂的实际需求。