Scala编译器Jar包搜索顺序及SBT、IntelliJ规则咨询

Scala编译器本身的规则 #

Scala编译器（scalac）没有独立的Jar包搜索顺序规则，它完全遵循传入的classpath顺序：classpath中排在前面的Jar包会被优先扫描，一旦找到目标类，就会停止后续扫描，后面Jar包中的同名类会被忽略。

SBT的依赖与classpath顺序规则 #

SBT作为Scala生态的核心构建工具，会严格管理依赖的classpath顺序，核心规则如下：

• 直接依赖：按照build.sbt中声明的先后顺序排列在classpath中
• 传递依赖：采用「最近依赖优先」的调解规则：
  • 若同一依赖存在多版本，优先选择距离项目层级最近的版本（直接依赖 > 间接依赖）
  • 若依赖层级相同，则选择先声明的依赖对应的版本
• 可以通过执行sbt show dependencyClasspath命令，查看SBT最终传给编译器的完整classpath顺序

IntelliJ的处理逻辑 #

IntelliJ的Scala插件理论上会对齐SBT的依赖解析结果，但实际编译时可能出现差异，原因和它的内部机制有关：

• IntelliJ有独立的依赖解析和缓存机制，若索引未及时更新，可能导致classpath顺序和SBT不一致
• 使用IntelliJ自带的「Make」功能时，其classpath顺序基于自身项目模型，而非完全照搬SBT的classpath
• 可以通过以下方式对齐SBT：
  1. 开启sbt shell构建：在Settings > Build, Execution, Deployment > Build Tools > sbt中勾选Use sbt shell for build and import
  2. 手动同步项目：执行File > Sync Project with SBT
  3. 在File > Project Structure > Libraries中查看当前IntelliJ使用的库顺序

版本冲突解决建议 #

• 使用SBT的dependencyOverrides强制指定依赖版本，彻底避免版本歧义
• 执行sbt dependencyTree查看完整依赖树，排查传递依赖的版本冲突点
• 优先使用SBT的构建结果作为最终编译标准，减少IntelliJ独立构建的差异

内容的提问来源于stack exchange，提问作者Jon Strayer