Saltcorn项目中菜单高亮匹配问题的分析与修复

在Web应用开发中，导航菜单的高亮状态对于用户体验至关重要。Saltcorn作为一个开源的低代码平台，近期修复了一个关于菜单项高亮逻辑的边界情况问题。

问题背景

当系统中存在两个名称具有包含关系的页面时，例如"test"和"test-old"，原高亮逻辑会导致同时高亮两个菜单项。具体表现为：

• 访问/test页面时，仅"test"菜单项高亮（正常）
• 访问/test-old页面时，"test"和"test-old"同时高亮（异常）

技术原因分析

问题的根源在于菜单高亮判断逻辑使用了简单的字符串startsWith方法。在LayoutUtils模块中，原代码通过检查当前URL是否以菜单项路径开头来决定是否高亮。这种实现方式虽然简单，但无法处理路径前缀重叠的情况。

解决方案

修复方案改进了匹配逻辑，确保只有当URL路径完全匹配或符合特定父子关系时才触发高亮。具体实现要点包括：

1. 精确匹配优先：首先检查完全匹配的情况
2. 路径分隔符处理：确保比较时考虑路径分隔符边界
3. 子路径判断：对于嵌套路径，验证完整的路径段匹配

技术影响

这一修复：

• 提升了用户体验，确保导航状态清晰准确
• 保持了原有简单路径的匹配效率
• 为未来可能的路径匹配需求提供了更好的扩展性

开发者启示

在实现URL路径匹配逻辑时，需要考虑以下情况：

1. 路径前缀重叠
2. 路径分隔符处理
3. 大小写敏感性
4. 查询参数的影响

这个案例展示了即使是简单的字符串匹配功能，也需要考虑各种边界条件才能确保稳定可靠。Saltcorn通过这次修复，进一步完善了其核心导航功能的健壮性。