Fuzzysort库中_score与score属性的区别解析

在JavaScript模糊搜索库Fuzzysort的使用过程中，开发者khanhdo16遇到了一个关于评分结果的疑惑。当按照文档示例输出搜索结果时，发现_score属性返回的是负值，而非文档描述的浮点数评分。经过与项目维护者的交流，揭示了_score和score这两个属性的重要区别。

问题现象

开发者在使用Fuzzysort 3.0.2版本时，按照常规方式输出搜索结果对象，发现_score属性值为负数：

{
  _score: -1337,
  // 其他属性...
}

这与文档描述的"浮点数评分"预期不符，引发了使用困惑。

技术解析

实际上，Fuzzysort的结果对象包含两个相关但不同的评分属性：

1. score属性：这是官方文档中明确提到的评分值，表示匹配质量的浮点数，数值越大表示匹配度越高。

2. _score属性：这是内部使用的优化计算值，主要用于算法内部的排序比较。该值通常为负数，其绝对值越大表示匹配度越高，但开发者不应直接使用此值。

最佳实践

开发者在使用Fuzzysort时应当注意：

• 始终使用result.score获取匹配评分
• 避免直接使用result._score，除非有特殊需求
• 理解内部评分(_score)与外部评分(score)的差异

实现原理

这种设计源于性能优化的考虑：

1. 内部使用负数评分可以简化排序算法实现
2. 对外暴露的score属性经过转换，提供更直观的评分
3. 内部_score的负值特性有利于某些特定场景下的快速比较

总结

这个案例提醒我们，在使用开源库时：

1. 应仔细阅读文档，注意区分内部实现细节和公共API
2. 遇到预期外的输出时，首先检查是否使用了正确的属性/方法
3. 理解库的设计哲学有助于更好地使用其功能

Fuzzysort通过这种内外有别的评分设计，既保持了API的简洁性，又实现了算法的高效性，是值得学习的库设计范例。