SBT中编译前添加非托管Jar依赖及复制Jar的最早任务

1. 需添加非托管Jar依赖以使其可用于编译的最早任务是什么？ #

要让非托管Jar能被编译任务识别并使用，最早的关键节点是**unmanagedJars in Compile这个设置的计算阶段**。

SBT的编译类路径由managedJars（托管依赖）和unmanagedJars（非托管Jar）共同组成，而unmanagedJars是直接从unmanagedBase（默认是项目根目录的lib文件夹）扫描生成的。所有编译相关任务（比如compile、compileIncremental）都会依赖unmanagedJars的计算结果。只要确保Jar文件在unmanagedJars计算完成前被放到unmanagedBase目录，就能让它被纳入编译类路径。

2. 复制Jar到unmanagedBase的任务依赖时机问题 #

你遇到的“两次compile才生效”的问题，核心原因是任务依赖的时机不对：
当你直接把copyLibs绑定到compile任务体里时，copyLibs是在compile执行阶段才运行的，但SBT会在任务执行前提前计算好编译所需的所有输入（包括类路径）——此时copyLibs还没执行，Jar还没复制到位，第一次编译用的还是旧的类路径。第二次编译时，SBT检测到unmanagedBase目录的文件变化，会重新计算unmanagedJars，这时候Jar已经存在，才会生效。

要解决这个问题，你需要把copyLibs的依赖绑定到类路径计算的前置环节，而不是直接绑定到compile任务本身。最早且最精准的绑定点就是unmanagedJars in Compile，因为它是直接扫描unmanagedBase生成Jar列表的设置。你可以这样配置：

// 方式1：在unmanagedJars计算前执行copyLibs
unmanagedJars in Compile := {
  copyLibs.value // 先完成Jar复制
  (unmanagedJars in Compile).value // 再扫描目录获取最新的Jar列表
}

// 方式2：用dependsOn声明依赖关系（更符合SBT的规范写法）
unmanagedJars in Compile := (unmanagedJars in Compile).dependsOn(copyLibs).value

这样配置后，SBT在计算unmanagedJars in Compile时，会自动先执行copyLibs，确保Jar已经在unmanagedBase中，后续的编译任务就能直接使用最新的类路径，一次compile就会生效。

如果追求极端早的时机，理论上可以绑定到initialize任务，但这完全没必要——unmanagedJars的计算已经是编译类路径准备的最早阶段之一，绑定到这里既精准又不会影响其他无关任务的执行效率。

内容的提问来源于stack exchange，提问作者Klugscheißer