swimm verify命令校验范围及未触发校验失败问题咨询

Swimm校验未触发同步失效的常见原因 #

Swimm的代码片段校验逻辑和修改幅度没有直接的线性关联，主要由绑定片段时的匹配规则、上下文锚点命中情况决定，常见的未触发提示的原因如下：

• 你修改的内容不在文档绑定的代码片段的捕获范围内：Swimm绑定代码片段时会同时记录片段的前后锚点代码、所属文件路径、所属语法结构（类/函数）标识，如果你修改的是同文件下片段外的其他代码，或是仅修改了注释、空格、换行这类非逻辑内容，Swimm默认会忽略这类变更，不会判定同步失效。
• 片段开启了宽松匹配模式：创建代码片段时可以选择匹配敏感度，若选择宽松模式，单变量名修改、单行增减这类小幅度逻辑变更只要整体特征匹配度仍高于阈值，就不会触发失效提示，只有匹配度低于设定阈值时才会校验失败。
• 本地索引未更新：swimm verify会优先读取本地缓存的代码索引，你可以先执行swimm sync更新本地的代码与文档映射索引，再重新运行swimm verify校验，排除缓存导致的结果异常。
• 多文档独立快照差异：如果同一段代码被多个文档分别绑定，每份文档都会独立存储该片段的快照与匹配规则，你的修改可能仅命中了部分文档的失效阈值，另一部分文档的匹配规则仍能适配修改后的代码，因此不会全部触发失效提示。

如果需要稳定模拟校验失败的场景，可直接修改绑定片段的核心代码+前后锚点的特征行，即可触发校验不通过的提示。

内容的提问来源于stack exchange，提问作者michaelh