Ruby LSP 测试功能变更与文件路径规范解析

Ruby LSP 作为现代 Ruby 开发的重要工具，近期对其测试功能进行了重大更新。这次更新主要涉及测试文件的发现机制和路径规范，开发者需要了解这些变化以避免测试功能无法正常工作的情况。

测试发现机制的变化

最新版本的 Ruby LSP 引入了一套全新的测试发现机制，这套机制对测试文件的存放位置提出了明确要求。系统现在会按照特定的 glob 模式来识别测试文件：

**/{test,spec,features}/**/{*_test.rb,test_*.rb,*_spec.rb,*.feature}

这套模式设计考虑了性能优化因素，使得 LSP 能够高效地发现项目中的所有测试文件。如果测试文件不符合这个路径规范，Ruby LSP 将无法识别这些测试，导致测试运行按钮失效。

传统布局与新规范的冲突

许多 Ruby 开发者习惯将测试文件与实现文件放在同一目录下，例如：

lib/fetchers/
├── base_adapter.rb
├── job_fetcher.rb
├── test_base_adapter.rb
└── test_job_fetcher.rb

这种布局虽然直观且被许多其他语言采用，但不符合 Ruby LSP 新的测试发现规范。目前可以通过设置 fullTestDiscovery 特性标志暂时恢复旧有行为，但该标志将在未来版本中被移除。

对开发实践的影响

这一变更意味着开发者需要调整项目结构以适应新的规范。建议将测试文件统一放置在项目根目录下的 test 或 spec 目录中，这是 Ruby 社区更常见的做法，也符合 Ruby on Rails 等框架的约定。

对于坚持原有文件组织方式的开发者，需要考虑以下替代方案：

1. 使用自定义脚本运行测试
2. 创建符号链接将测试文件映射到规范路径
3. 考虑迁移到新的文件布局

未来改进方向

Ruby LSP 团队已经意识到需要为不符合规范的测试文件提供更好的反馈机制。当用户点击无法识别的测试项的代码透镜时，系统应该明确提示原因，而不是简单地不响应。

这一变更反映了工具开发中性能优化与开发者体验之间的平衡取舍。虽然短期内可能造成不便，但从长远来看，统一的文件布局规范有助于提高工具性能和开发效率。