Scala多单元文件是否应采用小驼峰命名？官方规范与实际实践的矛盾该如何解读？

这确实是个挺让人挠头的矛盾点，我当初刚接触Scala的时候也被这个搞懵过——一边是官方风格指南明确说多单元文件要用小驼峰命名，另一边是包括标准库在内的几乎所有实际代码都在“违反”这个规则，甚至连指南里的示例都没做到统一。

我来梳理下这里面的门道：

• 历史惯性的影响：Scala从诞生起就和Java深度绑定，很多早期Scala开发者都是Java转过来的，自然延续了Java“文件名与顶级类名一致（大驼峰）”的习惯。哪怕后来官方发布了风格指南，这种已经在社区扎根的命名方式也很难被撼动。
• 标准库的“例外”其实是常态：你提到的Option.scala就是典型例子——这类文件的核心就是那个同名的顶级类/特质，用大驼峰命名能直接让开发者“见名知意”，比小驼峰更符合直觉。事实上，Scala标准库里绝大多数文件都是这么做的，反而小驼峰命名的文件少之又少。
• 社区共识优先于官方指南：你问的资深开发者都不知道这个小驼峰约定，恰恰说明它在实际开发中根本没被普及。现在Scala社区默认的做法是：
  • 如果文件的核心是一个顶级类、特质或单例对象，文件名直接用它的大驼峰名称（比如UserRepository.scala对应UserRepository类）；
  • 如果是包含多个零散工具方法的“辅助性”文件，偶尔会用小驼峰，但这种场景其实不多见。

总结下来：不用纠结官方指南里这条没落地的规定，跟着社区主流走就好——毕竟代码是写给人看的，团队和社区的共识才是最实用的命名准则。

内容的提问来源于stack exchange，提问作者Jakub Krzętowski