Polymarket-Copy-Trading-Bot 编译全流程：fastLinkJS 与 fullLinkJS 到底有什么区别？-育师

【免费下载链接】polymarket-copy-trading-bot

A constantly evolving and thoughtful architecture for creating static blogs.

项目地址：https://gitcode.com/gh_mirrors/ev/polymarket-copy-trading-bot

Polymarket-Copy-Trading-Bot 是一个Play Framework + Scala.js前后端一体化的 sbt 多项目模板。新手最常卡住的点，就是编译流程中fastLinkJS与fullLinkJS这两个任务的差别：开发时走哪个、打包时走哪个、如何切换？这篇文章带你完整走一遍编译链路，把"开发态"和"发布态"一次性讲清楚。

项目结构：三个子项目如何分工

模板由 root 聚合三个子项目，这也是理解编译流程的前提：

子项目	职责	代表文件
`server`	Play 服务端（JVM）	Application.scala
`client`	Scala.js 客户端（编译成 JS）	ScalaJSExample.scala
`shared`	前后端共享的 Scala 代码	SharedMessages.scala

构建插件集中在模板的 plugins.sbt 中，其中关键的三个是sbt-web-scalajs（1.2.0）、sbt-scalajs（1.10.0）和sbt-plugin（Play 2.8.13），它们共同决定了下面所有编译任务的行为。

开发态编译：fastLinkJS 如何被触发

在开发阶段，你不需要手动调用fastLinkJS，它会被自动触发：

执行compile→ 自动触发 Scala.js 的fastLinkJS
执行run→ 每次页面刷新都会重新执行fastLinkJS
支持~compile、~run连续编译模式

$ sbt new vmunier/play-scalajs.g8 $ cd play-scalajs $ sbt sbt:root> project server [server] run $ open http://localhost:9000

fastLinkJS的特点是快：它只做增量式的 JS 链接，不做激进优化，所以秒级完成，适合改一行代码刷新一次的热循环。另外，Scala.js 项目里的编译错误会直接显示在浏览器中，调试体验接近 Web 前端开发。

发布态编译：切换 fullLinkJS 的完整步骤

上线打包时，fastLinkJS生成的 JS 体积和运行性能都不够理想，需要切换到fullLinkJS。做法是在打包命令前设置全局的scalaJSStage：

sbt 'set Global / scalaJSStage := FullOptStage' Universal/packageBin

执行后，打包流程会走fullLinkJS而不是fastLinkJS，得到经过完整优化（FullOptStage）的发布产物。

一句话总结两者区别

fastLinkJS：开发态、增量链接、速度快、优化少，compile/run/ 页面刷新自动触发
fullLinkJS：发布态、全量优化、速度慢但产物小且快，通过scalaJSStage := FullOptStage后由packageBin触发

Source Maps：两种链接模式都默认开启

一个容易踩的坑：很多人以为fullLinkJS后就没有调试信息了，其实两种模式默认都生成 Source Maps——打开浏览器 DevTools 依然可以打断点、定位到抛异常的源码行。

如果你确实要在发布包中去掉 Source Maps，需要在 Scala.js 项目里追加链接器配置：

Compile / fullLinkJS / scalaJSLinkerConfig ~= (_.withSourceMap(false))

CI 如何验证 Source Maps 配置

仓库里的 ci/checksourcemaps.sh 展示了完整的验证思路，值得学习：

sbt clean g8先生成模板实例
用FullOptStage打包两次：一次保留 Source Maps，一次用withSourceMap(false)关闭
解压 Procfile 指向的server-0.1.0-SNAPSHOT.zip，统计 jar 内.scala文件数量
断言：开启 Source Maps 时数量 > 0，关闭时数量 = 0

这个脚本本质上是把"fullLinkJS 打包产物是否符合预期"变成了一条可自动回归的检查线。

常见问题速查

问题	答案
什么时候用 fastLinkJS？	`compile`、`run`、页面刷新等开发场景，自动触发
什么时候用 fullLinkJS？	`Universal/packageBin`等发布打包，需先设`FullOptStage`
编译产物在哪里？	各子项目的`target`目录；`root/clean`可一次清理全部
刷新页面为什么能拿到新 JS？	`run`模式下每次刷新都会重新执行`fastLinkJS`
如何只加载 server 子项目？	在`build.sbt`中给`Global / onLoad`追加`project server`

小结

记住一条主线即可：开发走 fastLinkJS（快），发布走 fullLinkJS（优），切换开关是Global / scalaJSStage，而 Source Maps 两者默认全开。理解了这个"双模式编译"机制，你就能在这个 Play + Scala.js 模板里自如地完成从热开发到发布打包的全流程。