跨编译Scala版本时Sbt Plugin出现NoClassDefFoundError错误

问题根源 #

sbt 1.x系列基于Scala 2.12构建，插件代码必须用Scala 2.12编译才能被sbt正确加载运行。你直接用Scala 3.4.0或2.13.15编译插件，导致插件代码中引用的Scala API（比如scala.collection.immutable.StringOps）和sbt运行时的Scala版本不兼容，从而抛出类找不到的错误。

修复步骤 #

1. 修正插件项目的编译Scala版本 #

在build.sbt中设置：

sbtPlugin := true
scalaVersion := "2.12.19" // sbt 1.10.6推荐的兼容版本
crossScalaVersions := Seq("2.12.19") // 插件自身无需跨版本编译，仅需适配sbt的Scala版本

2. 在SharedSettings中兼容目标项目的Scala版本 #

插件要支持的Scala 3.4.0和2.13.15是应用插件的项目的版本，不是插件自身的编译版本。在SharedSettings.scala中，通过CrossVersion.partialVersion来区分不同版本的配置：

import sbt._
import Keys._

object SharedSettings {
  def commonSettings: Seq[Setting[_]] = Seq(
    organization := "com.yourorg",
    version := "0.1.0",
    // 根据目标项目的Scala版本设置编译选项
    scalacOptions ++= {
      CrossVersion.partialVersion(scalaVersion.value) match {
        case Some((3, _)) =>
          Seq("-language:implicitConversions", "-unchecked", "-deprecation")
        case Some((2, 13)) =>
          Seq("-Xlint", "-deprecation", "-Ywarn-unused")
        case _ => Seq.empty
      }
    },
    resolvers ++= Seq(
      Resolver.mavenLocal,
      Resolver.typesafeRepo("releases")
    )
  )
}

3. 避免直接引用版本敏感的Scala API #

如果你的代码中直接使用了scala.collection.immutable.StringOps这类在Scala 2和3中位置/实现有差异的API，替换为兼容写法：

• 改用Scala标准库中跨版本兼容的集合操作，比如直接用字符串的方法（如.map、.filter），无需显式引用StringOps
• 若必须用，通过条件编译处理：

import scala.collection.{StringOps => CrossStringOps} // Scala 3中的位置
// 或者针对Scala 2的条件编译
// #if scalaversion < 3
import scala.collection.immutable.StringOps as CrossStringOps
// #endif

4. 重新编译插件 #

执行以下命令清理并重新编译：

sbt clean compile

之后再发布插件，其他项目引入时即可正常使用，且能支持指定的Scala版本。

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