如何快速上手 Polymarket-Copy-Trading-Bot:从零跑通 Play + Scala.js 全栈项目的完整步骤
如何快速上手 Polymarket-Copy-Trading-Bot:从零跑通 Play + Scala.js 全栈项目的完整步骤
Polymarket-Copy-Trading-Bot 是一个基于 Play 框架 与 Scala.js 的全栈项目模板,采用"前后端同语言(Scala)"的架构:server 端负责 Web 服务,client 端在浏览器中运行,shared 模块让两端共享同一份 Scala 代码。本文带你从零开始,按完整步骤跑通这个 Play + Scala.js 全栈项目,最快 5 分钟即可在浏览器看到 "It works!" 页面输出。
📌 项目简介:Play + Scala.js 全栈架构长什么样?
这个项目通过 sbt-web-scalajs 插件 将 Play 与 Scala.js 深度集成,生成后的应用包含三大目录:
| 目录 | 角色 | 说明 |
|---|---|---|
server |
服务端 | Play 应用,提供路由、控制器与模板渲染 |
client |
客户端 | Scala.js 应用,编译为 JS 在浏览器中运行 |
shared |
共享模块 | 服务端与客户端共用的 Scala 代码 |
一次典型的请求链路是:浏览器页面里的 ScalaJSExample.scala 调用共享消息 SharedMessages.scala,再由 Application.scala 控制器把同一句话渲染进首页——三端各司其职,这正是"全栈同语言"的价值所在。
📖 更多背景可阅读项目自带的 README.md。
🧰 环境准备:只需 2 个工具
开始之前,请确认电脑上已安装:
- JDK 8+(Scala 与 sbt 的运行基础)
- sbt(Scala 构建工具,负责编译 server 与 client 两侧代码)
验证是否安装成功:
$ java -version
$ sbt --version
⏱️ 提示:首次运行 sbt 会自动下载依赖,耗时较长属于正常现象,请耐心等待。
🚀 最快上手步骤:5 分钟跑通项目
第一步:克隆仓库
$ git clone https://gitcode.com/gh_mirrors/ev/polymarket-copy-trading-bot
$ cd polymarket-copy-trading-bot
第二步:启动 sbt 并切换到 server 子项目
根项目聚合了所有子项目(server、client、shared),进入后先切换到服务端:
$ sbt
sbt:root> project server
第三步:启动应用
[server] run
第四步:打开浏览器验证
访问 http://localhost:9000 ,看到页面上的 "It works!" 字样,说明 Play 服务端与 Scala.js 客户端已全部跑通 ✅。
💡 支持
~run连续编译模式:保存代码后自动重新构建,开发时非常方便。
⚙️ 核心特性:开发效率提升点
| 操作 | 触发的 Scala.js 任务 | 效果 |
|---|---|---|
compile |
fastLinkJS |
快速增量编译前端代码 |
run |
fastLinkJS |
每次刷新页面自动重新链接 |
~compile / ~run |
连续编译 | 热更新,改完即生效 |
其他值得了解的特性:
- 编译错误可视化:Scala.js 项目的编译错误会直接显示在浏览器中,不用来回翻控制台;
- Source Maps 默认开启:打开浏览器开发者工具即可打断点、定位抛异常的代码行(
fastLinkJS与fullLinkJS均默认启用); - 生产打包一键切换:打包前把
scalaJSStage设为FullOptStage,即可执行fullLinkJS生成优化后的产物:
sbt 'set Global / scalaJSStage := FullOptStage' Universal/packageBin
部署时 Procfile 已定义好启动命令,application.conf 中配置了静态资源路径 /assets,配合 routes 中的资产路由即可完整服务前端文件。
🖥️ IDE 集成:IntelliJ 与 Eclipse 导入步骤
IntelliJ
- 打开 Project wizard,选择
Import Project,选中项目根目录; - 选择
Import project from external model→SBT project; - 点击
Next并勾选附加导入选项,Finish完成导入。
⚠️ 请确保使用 IntelliJ Scala 插件 v2017.2.7 或更高版本,旧版本存在已知兼容问题。
Eclipse
- 在
project/plugins.sbt中加入 sbteclipse 插件(版本 5.2.4); - 在
build.sbt的 server 配置中加入EclipseKeys.preTasks := Seq(Compile / compile),先生成 Twirl 模板的源文件; - 运行
sbt "eclipse with-source=true"; - 在 Eclipse 中选择
File/Import/General/Existing project...,选中根目录,取消勾选第三个复选框(仅导入 client、server 和 shared/.jvm),点击Finish:
🧹 清理与进阶小技巧
- 一键清理所有子项目:
root项目聚合了全部子项目,执行sbt clean即可统一清理; - 启动时自动加载 server 项目:在
build.sbt中加入Global / onLoad := (Global / onLoad).value.andThen(state => "project server" :: state),省掉每次手动切换; - 持续集成检查:仓库中的 ci/checksourcemaps.sh 演示了如何在 CI 中验证 Source Maps 是否按要求打包进产物,可作为你流水线脚本的参考。
❓ 常见问题排查
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
首次 run 卡住不动 |
sbt 正在下载依赖 | 保持网络通畅,等待下载完成 |
| 页面刷新后前端改动不生效 | 未触发 fastLinkJS |
确认使用了 run 而非手动启动 jar 包 |
| IntelliJ 导入报错 | Scala 插件版本过低 | 升级到 v2017.2.7+ |
| Eclipse 中缺少模板文件 | 未先编译 server | 添加 EclipseKeys.preTasks 后再重新生成 |
✅ 小结
按照本文的完整步骤,你已经完成了:克隆仓库 → 启动 sbt → 切换 server 子项目 → 打开浏览器看到 "It works!"。至此,Play + Scala.js 全栈项目已在本地跑通——接下来就可以把 shared 里的逻辑扩展为你的业务代码,让服务端与浏览器共享同一份 Scala 实现。祝开发顺利 🚀
