SBT 常用开发技巧

SBT 一直以来都是 Scala 开发者不可言说的痛，最主要的原因就是官方文档维护质量较差，没有经过系统的、循序渐进式的整理，导致初学者入门门槛较高。虽然也有其它构建工具可以选择(例如 Mill)， 但是在短时间内基本上不可能撼动 SBT 的地位，毕竟它是 Scala 名正言顺的亲儿子。当然还有另外一个原因可能导致其它构建工具永远没有机会，Scala 语言以其卓越的编译器著称，编译器支持的丰富特性需要和构建工具进行无缝对接，例如 Scala 的 Macro 需要和构建工具的增量编译密切配合，在和编译器对接方面，SBT 具有先天优势。既然别无选择，只能选择默默忍受。下面分享在SBT使用过程中的一些常用技巧。

设置 JVM 参数

有时候我们发现 SBT 编译速度异常缓慢，甚至直接报 OutOfMemory，这时我们就需要调整 JVM 堆大小。在 SBT 中，有三种方式可以设置 JVM 参数，下面分别介绍。

环境变量

设置 JAVA_OPTS 环境变量，例如在 Windows 命令行上执行：

set JAVA_OPTS="-Xmx1g -Xmx1g"

配置文件

在项目根目录下创建.jvmopts文件，内容如下：

-Xmx1g 
-Xmx1g

命令行参数

只有用于类Linux平台的sbt脚本支持命令行参数方式，用于Windows平台的sbt.bat无缘该方式，这种不统一的做法竟然没有任何文档说明，哎！用法如下，-J 后面的内容会被直接用作 JVM 参数：

sbt -J-Xmx1g

另外，我们也可以通过 -D 设置 JVM 的系统属性，值得欣喜的是，sbt.bat 脚本也是支持 -D 参数的：

sbt -Dprop=value

自动触发任务

在 SBT 任务名前加上 ~ ，则当有文件变化时则会自动触发该任务，例如我们在 Play 开发时，可以这样启动项目：

sbt ~run

当我们修改了某些文件时，SBT 会自动进行增量编译。

监测任务执行时间

当我们发现执行 sbt run 启动项目后，浏览器界面久久刷新不出来，这时我们就需要知道时间到底耗在哪儿了？执行如下命令则会打印各个任务的执行时间：

sbt -Dsbt.task.timings=true clean run

如果是Windows的话需要在参数两边加引号：

sbt "-Dsbt.task.timings=true" clean run

命令输出如下：

D:\IdeaProjects\play-community> sbt "-Dsbt.task.timings=true" clean run
[info] Loading settings from gpg.sbt,idea.sbt ...
[info] Loading global plugins from C:\Users\xiaomi\.sbt\1.0\plugins
Total time: 1602 ms
 {file:/C:/Users/xiaomi/.sbt/1.0/plugins/}global-plugins/*:update              : 755 ms
 {file:/C:/Users/xiaomi/.sbt/1.0/plugins/}global-plugins/compile:compileIncremental     : 394 ms
...