Userscripts项目中的@match路径匹配问题分析

问题背景

Userscripts是一款流行的用户脚本管理工具，在1.5.0版本更新后，部分用户报告了一个关于@match指令路径匹配的问题。具体表现为：当URL路径以斜杠(/)结尾时，匹配规则无法正常工作，而相同的规则在不以斜杠结尾的URL上却能正常匹配。

问题现象

用户报告了两个典型场景：

1. 规则@match https://example.com/和@match https://example.com/*无法匹配https://example.com/
2. 规则@match https://whattrainisitnow.com/calendar/*无法匹配https://whattrainisitnow.com/calendar/，但可以匹配https://whattrainisitnow.com/calendar/test

技术分析

经过深入调查，发现问题根源在于iOS 16以下版本和macOS 13以下版本中URL路径处理的差异。具体表现为：

1. 在这些旧版本系统中，当使用NSURL的path属性获取路径时，系统会自动去除路径末尾的斜杠
2. 例如，对于URLhttps://mozilla.org/path/，path属性返回的是/path而非预期的/path/
3. 这种差异导致路径匹配算法无法正确识别以斜杠结尾的URL

解决方案

正确的处理方式应该考虑以下因素：

1. 检查URL是否表示目录路径（通过hasDirectoryPath属性）
2. 对于目录路径，应保留末尾斜杠进行匹配
3. 需要针对不同系统版本实现兼容处理

经验总结

1. 跨版本兼容性测试的重要性：开发者需要确保在多个系统版本上进行充分测试
2. URL处理中的细节陷阱：路径末尾斜杠的处理在不同平台和版本上可能存在差异
3. 单元测试覆盖范围：需要包含各种边界条件的测试用例

最佳实践建议

对于用户脚本开发者：

1. 在编写@match规则时，明确是否需要匹配目录路径
2. 考虑同时提供带斜杠和不带斜杠的匹配规则，提高兼容性

对于工具开发者：

1. 实现路径处理时需要考虑不同系统版本的差异
2. 建立全面的测试用例，覆盖各种URL格式
3. 文档中明确说明路径匹配的行为特性

这个问题提醒我们，在开发跨平台、跨版本的工具时，需要特别注意系统API的细微差异，特别是像URL处理这种基础但容易出错的领域。