MangoHud中fps_only参数导致FPS计数器重复显示的解决方案

问题现象分析

MangoHud是一款流行的Linux游戏性能监控工具，用户报告在使用fps_only参数时遇到了FPS计数器重复显示的问题。具体表现为：

1. 初始启动时，FPS计数器会显示三次而非预期的一次
2. 每次通过Shift_L+F4重新加载配置后，计数器数量会继续增加
3. 该问题在多个游戏环境中均能复现，包括原生Linux游戏和通过兼容层运行的Windows游戏

技术背景

MangoHud的显示系统采用模块化设计，通过ordered_functions容器管理需要显示的各个元素。当用户指定fps_only参数时，理论上应该只保留FPS计数器这一个显示项。然而在实际实现中，存在以下技术细节：

1. 配置重载机制会保留原有显示元素
2. 现代布局模式(legacy_layout=false)下的元素排序逻辑存在缺陷
3. FPS计数器元素在每次重载时被重复添加而未被清除

根本原因

经过代码分析，发现问题出在overlay_params.cpp文件中的配置解析逻辑：

1. 当使用现代布局模式时，系统会遍历HUDElements.options来排序显示元素
2. 但在开始排序前，没有清空原有的ordered_functions容器
3. 导致每次重载配置时，FPS计数器元素被重复添加
4. 而legacy_layout模式下由于使用不同的初始化方式，不会出现此问题

解决方案

开发者提出的修复方案是在开始排序前清空ordered_functions容器：

if (params->enabled[OVERLAY_PARAM_ENABLED_legacy_layout]) {
   HUDElements.legacy_elements();
} else {
   HUDElements.ordered_functions.clear();  // 新增的清空操作
   for (auto& option : HUDElements.options) {
      HUDElements.sort_elements(option);
   }
}

这个修改确保：

1. 每次配置重载都会从干净的容器开始
2. 只添加当前配置要求的显示元素
3. 避免元素重复累积的问题

用户临时解决方案

在官方修复发布前，用户可以采取以下临时措施：

1. 使用legacy_layout模式：在配置中添加legacy_layout=1
2. 避免频繁重载配置，特别是使用fps_only模式时
3. 考虑使用配置文件而非命令行参数，减少重载需求

技术启示

这个案例展示了几个重要的软件开发经验：

1. 状态管理的重要性：在重用容器前必须确保其处于正确状态
2. 边界条件测试：配置重载这种特殊场景需要特别关注
3. 模式一致性：不同布局模式应该保持相同的行为表现

该问题的修复将包含在MangoHud的下一个版本中，为用户提供更稳定可靠的性能监控体验。