SBT：如何根据Windows/Linux构建平台动态切换JAR依赖

这个需求在跨平台项目里太常见了，尤其是涉及到native依赖或者系统专属工具包的时候。在sbt里实现起来很直观，核心就是利用sbt提供的系统检测能力，结合条件逻辑来动态声明依赖。下面给你几种实用的实现方式：

方法一：用sbt内置的Os枚举（推荐） #

sbt 1.x及以上版本内置了Os工具类，可以直接判断当前操作系统，代码可读性很高：

import sbt.Os

name := "CrossPlatformDemo"
version := "1.0.0"
scalaVersion := "2.13.12"

// 定义平台专属依赖
val platformSpecificDeps = Os.current match {
  case Os.Windows =>
    Seq(
      "com.yourcompany" % "windows-sdk" % "2.1.0",
      "org.native" % "win32-utils" % "1.5.0" % Runtime // 仅运行时依赖
    )
  case Os.Linux =>
    Seq(
      "com.yourcompany" % "linux-sdk" % "2.1.0",
      "org.native" % "glibc-utils" % "1.5.0" % Runtime
    )
  case _ =>
    // 可选：处理Mac或其他系统，这里默认返回空依赖
    println("⚠️  当前操作系统未适配，将跳过平台专属依赖")
    Seq.empty
}

// 合并通用依赖与平台专属依赖
libraryDependencies ++= Seq(
  "org.scala-lang.modules" %% "scala-async" % "1.0.0",
  "org.scalatest" %% "scalatest" % "3.2.15" % Test
) ++ platformSpecificDeps

方法二：直接读取系统属性 #

如果你不想导入sbt.Os，也可以直接读取JVM的os.name系统属性，兼容性更好：

name := "CrossPlatformDemo"
version := "1.0.0"
scalaVersion := "2.13.12"

val platformDeps = {
  val osName = System.getProperty("os.name").toLowerCase
  osName match {
    case n if n.contains("win") =>
      Seq("com.yourcompany" % "windows-sdk" % "2.1.0")
    case n if n.contains("linux") =>
      Seq("com.yourcompany" % "linux-sdk" % "2.1.0")
    case _ => Seq.empty
  }
}

libraryDependencies ++= Seq(/* 通用依赖 */) ++ platformDeps

方法三：针对带Classifier的依赖 #

很多跨平台库会用classifier区分不同系统的JAR包（比如windows-x86_64、linux-amd64），这种场景可以动态设置classifier：

import sbt.Os

val coreLibVersion = "3.0.0"
val coreLibClassifier = Os.current match {
  case Os.Windows => "windows-x86_64"
  case Os.Linux => "linux-amd64"
  case _ => ""
}

libraryDependencies += "com.example" % "core-native-lib" % coreLibVersion classifier coreLibClassifier

注意事项 #

• 如果需要在CI中跨平台构建（比如在Linux上打包Windows版本），可以通过命令行参数强制指定系统：sbt -Dos.name=Windows_NT package
• 确保平台专属依赖的坐标（groupId、artifactId、version）完全正确，避免构建失败
• 可以根据需求将依赖放到不同的配置域（比如Test、Runtime），只需在依赖后追加% 配置名

这样就能让你的sbt项目自动根据构建平台加载对应的JAR依赖了，日常开发和CI流程都能完美适配～

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